On 5/10/2013 08:31, Christopher Faylor wrote:
I don't know what Corinna's return has to do with this.
http://cygwin.com/ml/cygwin-patches/2013-q2/msg00011.html
The open question is whether we're going to switch all the DOCTOOL tags
and *.sgml in winsup/cygwin to Doxygen, or keep it as DocBook but move
it all to winsup/doc.
I can do it either way. I just think Doxygen gets us more with less
effort. (DocBook is still the way to go for prose-heavy documents like
the Cygwin FAQ and user manual.)
One Doxygen advantage I haven't mentioned yet: the most basic sort of
Doxygen comments on the POSIX interfaces would get Cygwin a set of basic
man2 pages for cheap.
I don't propose to try and replace the POSIX docs or the Linux man
pages, but at least we could give vi users pressing K on a syscall a
parameter list and return value description.
If you're making the call now, nixing the Doxygen conversion idea, I can
start moving the docs out of the source subdirectories.
--
Problem reports: http://cygwin.com/problems.html
FAQ: http://cygwin.com/faq/
Documentation: http://cygwin.com/docs.html
Unsubscribe info: http://cygwin.com/ml/#unsubscribe-simple
