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=
Mailing-List: contact cygwin-help@cygwin.com; run by ezmlm
Sender: cygwin-owner@cygwin.com
Mail-Followup-To: cygwin@cygwin.com
Date: Mon, 13 May 2013 16:34:44 +0200
From: Corinna Vinschen <corinna-cygwin@cygwin.com>
To: cygwin@cygwin.com
Subject: Re: Cygwin manpages clobbered
Message-ID: <20130513143444.GB8890@calimero.vinschen.de>
Reply-To: cygwin@cygwin.com
Mail-Followup-To: cygwin@cygwin.com
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> <518D2AA8.6060701@etr-usa.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
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