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 1QagLq-0006ph-VO for garchives@archives.gentoo.org; Sun, 26 Jun 2011 03:49:39 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7F4141C0B6; Sun, 26 Jun 2011 03:49:21 +0000 (UTC) Received: from smtprelay02.ispgateway.de (smtprelay02.ispgateway.de [80.67.31.40]) by pigeon.gentoo.org (Postfix) with ESMTP id 446C91C0B6 for ; Sun, 26 Jun 2011 03:49:21 +0000 (UTC) Received: from [85.179.7.97] (helo=[192.168.1.2]) by smtprelay02.ispgateway.de with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.68) (envelope-from ) id 1QagLY-0003G2-ET for gentoo-catalyst@lists.gentoo.org; Sun, 26 Jun 2011 05:49:20 +0200 Message-ID: <4E06AC3D.4000901@gentoo.org> Date: Sun, 26 Jun 2011 05:49:17 +0200 From: Sebastian Pipping User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.2.17) Gecko/20110526 Thunderbird/3.1.10 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 To: gentoo-catalyst@lists.gentoo.org Subject: Re: [gentoo-catalyst] Migrating man page to asciidoc? References: <4E03DD4C.7050005@gentoo.org> <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> In-Reply-To: <20110626033613.GA6577@linux1> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Df-Sender: sping-gentoo@binera.de X-Archives-Salt: X-Archives-Hash: f4c275e499f49bccf42b1a72d997b999 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. I'm aware of git archive - it does not support handling of generated files afaik. >>> 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. > > That is exactly why I prefer the other option I mention below. Alright. On the other hand without dependencies you get nowhere: either you don#t have features or you build every wheel yourself. >>> or we can go back to the manpage that is in the git >>> repository. >> >> Do I have to list reasons against this option? > > I think it would be helpful if you did since you did the conversion > without discussing it with the rest of the team first. 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. Benefits of the current Asciidoc approach: - No need to write *roff manually. Plus Asciidoc syntax is more readable. - Man page keeps itself in sync on - list of subarches - version of catalyst - Option to make XHTML from the same source Best, Sebastian