X-Recipient: archive-cygwin AT delorie DOT com
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
	=
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; 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;
	 s=default; bh=62GH/qIAngvPMZRAL9TORehY9a4=; b=dpVdHYZkHpLMy8zYb
	nozSU9a+EIv9qpF61ESjlrw4tdHofYFAp50MHV/gcN/Xb4LJm/J7zYR3BTUDGvko
	3sC+QD+kMdVEfyDW7pwL/sNzWpGwyNLH/ZzgWkXFqgvV4sDEHk7+01/daRyikzAt
	0kGFnVk3TBRmFDEjupljmCuQm4=
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com
X-Spam-SWARE-Status: No, score=-4.5 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RP_MATCHES_RCVD autolearn=ham version=3.3.1
Message-ID: <518D2AA8.6060701@etr-usa.com>
Date: Fri, 10 May 2013 11:13:12 -0600
From: Warren Young <warren AT etr-usa DOT 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 AT cygwin DOT com
Subject: Re: Cygwin manpages clobbered
References: <5F8AAC04F9616747BC4CC0E803D5907D0AF787B3 AT MLBXv04 DOT nih DOT gov> <518C55BD DOT 7020807 AT etr-usa DOT com> <20130510041245 DOT GA3019 AT ednor DOT casa DOT cgf DOT cx> <518CC275 DOT 2060207 AT etr-usa DOT com> <20130510142904 DOT GA6201 AT ednor DOT casa DOT cgf DOT cx> <20130510143137 DOT GA1135 AT ednor DOT casa DOT cgf DOT 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