[FFmpeg-devel] [RFC] Should we use doxygen markup?
Sun Apr 19 14:58:43 CEST 2009
as recently discussed.
Read for example:
* improves doxygen (LaTeX/HTML) rendering.
* it may result more clear in some specific situation even for plain
docs. For example:
"reads the foo string \p string"
"reads the foo string from string"
helps to distinguish the use of a term for referring to a parameter
rather to the generic meaning of its name.
* it may make plain docs less readable, and most people read plain
docs rather than autogenerated ones.
I'm biased towards keeping them, while Michael wants to remove them
all, what's certain is that we should try to keep a consistent style
in docs, so if we decide for removing them we should remove them
everywhere, or strive to use them (at least in new doxyies).
I'd like to hear what people think, especially from Diego.
FFmpeg = Frenzy & Faboulous Mournful Puritan Easy Gospel
More information about the ffmpeg-devel