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: List-Subscribe: List-Archive: List-Post: List-Help: , 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 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