Cygwin manpages clobbered

[Warren Young]

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