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:date:from:to:subject:message-id:reply-to
	:references:mime-version:content-type:in-reply-to; q=dns; s=
	default; b=hU/P0Gbhjf/1/JuYdphXToqOflK8PqyLqVBUSSHCrY5BjP/QXGYdX
	4CnDvZUSco8vi1t6NFXssyLOJFTRG454OHzlfrYl1MZn0t9A3a3XEmRAQW03SbE7
	kBwlww3YZdKpXxhFdM0kbwNoQNrt1llaxbDp9Sj/3i/hYtNyEPokU0=
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:date:from:to:subject:message-id:reply-to
	:references:mime-version:content-type:in-reply-to; s=default;
	bh=m+6YGtNzOanrfxkkFKeCyM9KSRY=; b=fTyfdfqDVu88sqSOncJAohJzJDkK
	KALygB3YLKK1cV9bByaZ0QOeYO+HbUF3I+4hX3b/+mE8vLJKarTqm55xUYdBQXr9
	0XyFSU1Objh8VUuzmAqbEwDWd3WkRzmefq0TnazR8n8P0/YhXwYlWhUv07hrdHIg
	kQlHGQ7ms3+By7Y=
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=-1.8 required=5.0 tests=AWL,BAYES_00 autolearn=ham version=3.3.1
Date:	Mon, 13 May 2013 16:34:44 +0200
From:	Corinna Vinschen <corinna-cygwin AT cygwin DOT com>
To:	cygwin AT cygwin DOT com
Subject:	Re: Cygwin manpages clobbered
Message-ID:	<20130513143444.GB8890@calimero.vinschen.de>
Reply-To:	cygwin AT cygwin DOT com
Mail-Followup-To:	cygwin AT cygwin DOT com
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> <518D2AA8 DOT 6060701 AT etr-usa DOT com>
MIME-Version:	1.0
In-Reply-To:	<518D2AA8.6060701@etr-usa.com>
User-Agent:	Mutt/1.5.21 (2010-09-15)

On May 10 11:13, Warren Young wrote:
> 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.

Here's what I need:  Show me a doxygen example of a former docbook
man page.  I'd like to know what I'm getting myself into.

And what about the fact that the man pages for the Cygwin commands
are also embedded into the user manual.  Will that still work?

If that looks fine, I have no problem, but right now I tend to stick
to docbook so I only have a single layout to write any Cygwin docs...

Other than that, if you take over cygwin-docs, I'm happy for cgf, but
I have nothing to do with this decision :)


Corinna

-- 
Corinna Vinschen                  Please, send mails regarding Cygwin to
Cygwin Maintainer                 cygwin AT cygwin DOT com
Red Hat

--
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

- Raw text -