[PATCH] doc: Mostly fixing up i.e. versus i.e.\ in doxygen documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



> > same for e.g. versus e.g.\ and e.g. versus E.g.
> > this is ueber-nitpicking: will anybody ever notice?

> You did, apparently ;-)
> Anyway, why should there be a \ after "e.g."?

to be compliant with doxygen magic

doxygen assumes that the first sentence of a description (terminated by a 
'.') is kind-of a summary of the text; doxygen puts some extra space after 
the first sentence

if the first sentence reads
"Bla bla e.g. bla bla."
then doxygen detects the end of the first sentence after 'e.g.' (the first 
'.' followed by whitespace)

"Bla bla e.g.\ bla bla." fixes this; the end of the first sentence is now 
correctly detected after 'bla.'

regards, p.

-- 

Peter Meerwald
+43-664-2444418 (mobile)


[Index of Archives]     [Linux Audio Users]     [AMD Graphics]     [Linux USB Devel]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux