From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 102549 invoked by alias); 16 Jun 2015 19:17:17 -0000 Mailing-List: contact cygwin-patches-help@cygwin.com; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Post: List-Archive: List-Help: , Sender: cygwin-patches-owner@cygwin.com Mail-Followup-To: cygwin-patches@cygwin.com Received: (qmail 102539 invoked by uid 89); 16 Jun 2015 19:17:16 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-5.4 required=5.0 tests=AWL,BAYES_00,KAM_LAZY_DOMAIN_SECURITY autolearn=no version=3.3.2 X-HELO: calimero.vinschen.de Received: from aquarius.hirmke.de (HELO calimero.vinschen.de) (217.91.18.234) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 16 Jun 2015 19:17:16 +0000 Received: by calimero.vinschen.de (Postfix, from userid 500) id C5799A807DA; Tue, 16 Jun 2015 21:17:12 +0200 (CEST) Date: Tue, 16 Jun 2015 19:17:00 -0000 From: Corinna Vinschen To: cygwin-patches@cygwin.com Subject: Re: [PATCH 5/8] winsup/doc: Convert utils.xml to using refentry Message-ID: <20150616191712.GH31537@calimero.vinschen.de> Reply-To: cygwin-patches@cygwin.com Mail-Followup-To: cygwin-patches@cygwin.com References: <1434371793-3980-1-git-send-email-jon.turney@dronecode.org.uk> <1434371793-3980-6-git-send-email-jon.turney@dronecode.org.uk> <20150615171147.GE26901@calimero.vinschen.de> <557FEC25.8030303@dronecode.org.uk> <20150616094501.GC31537@calimero.vinschen.de> <558003FD.8060208@dronecode.org.uk> <20150616124934.GD31537@calimero.vinschen.de> <55805DF6.5040004@dronecode.org.uk> <20150616174933.GG31537@calimero.vinschen.de> <55806FF7.3010600@dronecode.org.uk> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="XUd+PsnCfaVdInSg" Content-Disposition: inline In-Reply-To: <55806FF7.3010600@dronecode.org.uk> User-Agent: Mutt/1.5.23 (2014-03-12) X-SW-Source: 2015-q2/txt/msg00081.txt.bz2 --XUd+PsnCfaVdInSg Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-length: 1945 On Jun 16 19:50, Jon TURNEY wrote: > On 16/06/2015 18:49, Corinna Vinschen wrote: > >>Note that the next time you build documentation for the website, you mi= ght > >>need to take some special steps to add new .html files. > > > >-v, please? >=20 > Sorry, I wasn't being intentionally vague, but I don't know precisely how > you push documentation updates. >=20 > I guess you will need to do a 'cvs add *.html' Oh, I see. I didn't realize from the start that utils.xml is also split into multiple html files now. > >>and next time you build a package you might need to take some special s= teps > >>to exclude /usr/share/man/ > > > >What special steps? I assume a `make install' will install the > >additional man pages now. Wouldn't it make sense to install them as > >part of the Cygwin package then, rather than as part of cygwin-doc? >=20 > Ultimately, I think it would be a good idea if cygwin-doc was generated by > the same process which builds the cygwin(|-devel|-debuginfo) packages. Yes, that sounds right to me... > But we are some way from there yet. ...and I'm open to patches to make it reality :) > My thought was that the simplest way to do the transition is to exclude a= ll > the files currently owned by cygwin-doc until then, but maybe you have a > different idea. Hmm, no. The cygwin package comes with the PDF and HTML files under /usr/share/doc/cygwin-${PV}, the cygwin-devel package with the files /usr/share/man/man3/regex.3.gz /usr/share/man/man7/regex.7.gz (and an undesired usr/share/man/man3/2.0.3.gz, which I only now see. Oh well) In theory these man pages as well as the other doc files would be ideally bundled with the cygwin-doc package at one point. For the time being, I look into excluding the utils man pages in the cygwin package. Corinna --=20 Corinna Vinschen Please, send mails regarding Cygwin to Cygwin Maintainer cygwin AT cygwin DOT com Red Hat --XUd+PsnCfaVdInSg Content-Type: application/pgp-signature Content-length: 819 -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBCAAGBQJVgHY4AAoJEPU2Bp2uRE+gn+sP/1b/aBeRt6L74t5ZKzW4+L72 c8YI5+cf22e82YjPO3N/soDzalg6w/fcqPb1DBv6u9/0yMf14DEliI/G2fSDiSJ3 bQYJPbmaVP/U51pZ+SNpl4rItTWwGCSyhDgB0cEpX6WwYPjviegA9jtDFJd5R+cq annTRFrGZq1/ikWcSXLzaQQp0LaBNejagyfilQm4OdxOnlWR8B/8jO5RhmXQS3PF oqByWpztM1liU65v6yMO5JcTeEBap/XRpL2Gh/oVsZwxAripHsrzhxj0eWuAh+sg MWieQbzAsDxefy5l196JiYU4UMxOE2v9Laugtq/BEEL1zlV3SnTE7bhtByY4j55l /ub0NXuYa5WsUC66Z564EDVXWvpGm1r5CUgIKy4pFiSPxuj+gOME1i4UBdnkOj4/ OfBv5JASmfDyArWYCZUG+2avDWGiZ1YdAbSM+cVlAmxtNRYA4O5SSFAJaFYljqFB fNflKiKzryvL8/D58hqa4xdJdgZau1rZTqH2vY7O07jGiSPkPp/enX8Zjc8URWto z6lomxMHh3R2KZmAp0I/buEs4tWWhJczuPY2wmUVQgkPihKS1Kyk8qaXoRu+iIg8 HmRnlJwJRZ+91l8T1FaO/3hHKpaz/ncefQd/CTUzMAS2gDBomZh2SlyYWnNip4Gf 9OdgknFrdRkXw6H/Ve45 =wktY -----END PGP SIGNATURE----- --XUd+PsnCfaVdInSg--