Entertaining documentation format defect


#1

[attachment=0]Screen shot 2010-03-28 at 1.30.20 PM.png[/attachment] from http://www.rawmaterialsoftware.com/api/classFile.html#3e19cafabb03c5838160263a6e76313d

The breaks between paragraphs are wrong (at least on OS/X 10.6, FF and Chrome) so that the last line of each paragraph appears with the next line.

I was trying to puzzle out why the tempDirectory would be read-only, and then I realized that Jules really isn’t telling us to delete the currentExecutable file… :smiley:

[edit: it’s probably a Doxygen issue but perhaps there’s a setting in the HTML generation that will avoid this?]


#2

Wow - that is really confusing! I can’t see a way to avoid it by changing the comments, maybe there’s some kind of css hack possible, but I’m not much of an expert on that kind of thing…