From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1Qah2d-0006vo-Nc for garchives@archives.gentoo.org; Sun, 26 Jun 2011 04:33:52 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 691C21C10D; Sun, 26 Jun 2011 04:33:33 +0000 (UTC) Received: from mail-gw0-f53.google.com (mail-gw0-f53.google.com [74.125.83.53]) by pigeon.gentoo.org (Postfix) with ESMTP id 3AE191C10D for ; Sun, 26 Jun 2011 04:33:33 +0000 (UTC) Received: by gwj20 with SMTP id 20so2466109gwj.40 for ; Sat, 25 Jun 2011 21:33:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:sender:date:from:to:subject:message-id :mail-followup-to:references:mime-version:content-type :content-disposition:in-reply-to:user-agent; bh=Tabrh7qMvvxrwlk0FQlN3uZS1Hc0y6CVap0cXn5olFY=; b=lOhO+cOKoz4exsaHxdJu0AzD2M2W3NMLAAYRb2TigJpl1LUyiy7H2DREnd6LnDS7ws F/dTHe4UY3vsEabET6NzUjXGe41bmMiNWFQNZWHT65mZgfGTZR6PmkfWirC6FUWyG07O WfYFC3olyPOGgC7qiN4AnoSs5S8tWSndas8Nw= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=sender:date:from:to:subject:message-id:mail-followup-to:references :mime-version:content-type:content-disposition:in-reply-to :user-agent; b=PfW2xq6DswXHlCdL8DZt3Qtvq9BP81K6sw/R1YWL7p+Zshx2J1k3QJ2esmK0fwUnhr AS/AjYPsFGpkbNsGSJg2IXSk2+2LcwsAuVIJob8G/jMkioAa0IYAEWP+dmJskjRyZcsB 3XKRMo7URibBYJyaYoK/OhqcG13sdZzUYsexo= Received: by 10.101.194.20 with SMTP id w20mr4173190anp.19.1309062812658; Sat, 25 Jun 2011 21:33:32 -0700 (PDT) Received: from linux1 (cpe-76-187-76-173.tx.res.rr.com [76.187.76.173]) by mx.google.com with ESMTPS id b25sm4153164anb.46.2011.06.25.21.33.30 (version=SSLv3 cipher=OTHER); Sat, 25 Jun 2011 21:33:32 -0700 (PDT) Sender: William Hubbs Received: by linux1 (sSMTP sendmail emulation); Sat, 25 Jun 2011 23:33:29 -0500 Date: Sat, 25 Jun 2011 23:33:29 -0500 From: William Hubbs To: gentoo-catalyst@lists.gentoo.org Subject: Re: [gentoo-catalyst] Migrating man page to asciidoc? Message-ID: <20110626043329.GA6710@linux1> Mail-Followup-To: gentoo-catalyst@lists.gentoo.org References: <1308899274.624.67.camel@tablet> <4E04C66B.4010302@gentoo.org> <4E061FD0.4050009@gentoo.org> <4E069B1F.8040409@gentoo.org> <20110626024929.GA6506@linux1> <4E06A41E.6000705@gentoo.org> <20110626033613.GA6577@linux1> <4E06AC3D.4000901@gentoo.org> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-catalyst@lists.gentoo.org Reply-to: gentoo-catalyst@lists.gentoo.org MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="wRRV7LY7NUeQGEoC" Content-Disposition: inline In-Reply-To: <4E06AC3D.4000901@gentoo.org> User-Agent: Mutt/1.5.21 (2010-09-15) X-Archives-Salt: X-Archives-Hash: bb6743ed3a7fc6c16c046f4b80c1717f --wRRV7LY7NUeQGEoC Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, Jun 26, 2011 at 05:49:17AM +0200, Sebastian Pipping wrote: > On 06/26/2011 05:36 AM, William Hubbs wrote: > > That is already done if you use "git archive" to generate the archive > > and use the tags in the git repository along with that. For an example, > > look at openrc's git repository. >=20 > I'm aware of git archive - it does not support handling of generated > files afaik. That's correct, everything has to be in the repository if you use it. The advantage of doing it that way is that anyone can come along whenever they want to and generate a tarball that exactly matches the one we generate at release time. Doing it the other way, they can't. =20 That is why I think we should make asciidoc an RDEPEND in the ebuilds and set up the makefile so that the user generates the content if we stick with using asciidoc. > >>> I see two ways around this: We can either make asciidoc a build time > >>> dependency so that the user can use something like "make manpage" to > >>> generate the manpage > >> > >> That adds quite some load on indirect dependencies for more or less > >> nothing, as seen with Matt earlier. > >=20 > > That is exactly why I prefer the other option I mention below. >=20 > Alright. On the other hand without dependencies you get nowhere: either > you don#t have features or you build every wheel yourself. =20 I'm not quite sure what you mean here. > >>> or we can go back to the manpage that is in the git > >>> repository. > >> > >> Do I have to list reasons against this option? > >=20 > > I think it would be helpful if you did since you did the conversion > > without discussing it with the rest of the team first. >=20 > Peter Volkov voted for it, Peter Stuge said the list was rather silent. > So I went for it. The migration in genkernel was of great help. I see > your apology in your other mail now, accepting. >=20 > Benefits of the current Asciidoc approach: >=20 > - No need to write *roff manually. I'll give you this one. :-) > Plus Asciidoc syntax is more readable. You can use man ./catalyst.1 to read the man page. >=20 > - Man page keeps itself in sync on >=20 > - list of subarches >=20 > - version of catalyst >=20 > - Option to make XHTML from the same source =20 The cons of the new approach, as I see it, are: * auto generated content in tarballs makes it impossible to create the exact same tarball twice. * Now we need to have a build time dependency, at least for the live ebuild, which pulls in about 34mb of downloads just to build the man page. Since we are just talking about a man page, imho this is a lot of bloat for very little gain. William --wRRV7LY7NUeQGEoC Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.17 (GNU/Linux) iEYEARECAAYFAk4GtpkACgkQblQW9DDEZThmCgCfRhYiT7MS4LH8/ZSklgZraF1e TzoAni48mmm4aVI08LKddCZFieyW6aGr =IqtB -----END PGP SIGNATURE----- --wRRV7LY7NUeQGEoC--