DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:message-id:date:from:mime-version:to:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	 q=dns; s=default; b=vlJ37Sj9xsOBcXpvsezr0tPiTAXppXGmHkO/rMQfEcp
	fATUIrLJKWMuscaPXF7mXlkq4uj975Vip44XbgTwkgZuviVinEBWN3ET+R4To3wU
	f4UfyCf7p8FyTYB+L1Yzz0iAcOYLVTeXoVu4THndzmYBTJetgU6UgqLyec9F9pHY
	=
Mailing-List: contact cygwin-help@cygwin.com; run by ezmlm
Sender: cygwin-owner@cygwin.com
Mail-Followup-To: cygwin@cygwin.com
Message-ID: <518D2AA8.6060701@etr-usa.com>
Date: Fri, 10 May 2013 11:13:12 -0600
From: Warren Young <warren@etr-usa.com>
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:17.0) Gecko/20130328 Thunderbird/17.0.5
MIME-Version: 1.0
To: cygwin@cygwin.com
Subject: Re: Cygwin manpages clobbered
References: <5F8AAC04F9616747BC4CC0E803D5907D0AF787B3@MLBXv04.nih.gov> <518C55BD.7020807@etr-usa.com> <20130510041245.GA3019@ednor.casa.cgf.cx> <518CC275.2060207@etr-usa.com> <20130510142904.GA6201@ednor.casa.cgf.cx> <20130510143137.GA1135@ednor.casa.cgf.cx>
In-Reply-To: <20130510143137.GA1135@ednor.casa.cgf.cx>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

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