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 1QahPa-0003Hs-IX for garchives@archives.gentoo.org; Sun, 26 Jun 2011 04:57:34 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7F4091C089; Sun, 26 Jun 2011 04:57:15 +0000 (UTC) Received: from smtprelay05.ispgateway.de (smtprelay05.ispgateway.de [80.67.31.99]) by pigeon.gentoo.org (Postfix) with ESMTP id 224D11C089 for ; Sun, 26 Jun 2011 04:57:15 +0000 (UTC) Received: from [85.179.7.97] (helo=[192.168.1.2]) by smtprelay05.ispgateway.de with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.68) (envelope-from ) id 1QahPG-0002AI-At for gentoo-catalyst@lists.gentoo.org; Sun, 26 Jun 2011 06:57:14 +0200 Message-ID: <4E06BC27.3020808@gentoo.org> Date: Sun, 26 Jun 2011 06:57:11 +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: <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> <20110626043329.GA6710@linux1> In-Reply-To: <20110626043329.GA6710@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: 3ea228d41e50af8b0f6274bad5a3db2b On 06/26/2011 06:33 AM, William Hubbs wrote: > 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. Frankly, I don't care about that feature. I care about content and Git tags that lead to content. >> Alright. On the other hand without dependencies you get nowhere: either >> you don#t have features or you build every wheel yourself. > > I'm not quite sure what you mean here. I was trying to say that you get quite something for the cost you put into dependencies. You save re-writing things yourself and you get more features for free. That's what the cost is for. >> Plus Asciidoc syntax is more readable. > > You can use man ./catalyst.1 to read the man page. Are you serious? I want syntax to be readable while editing, not after pre-processing. With that argument we could be writing man pages in assembly. > >> >> - Man page keeps itself in sync on >> >> - list of subarches >> >> - version of catalyst >> >> - Option to make XHTML from the same source > > 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. Again, i don't care. > * 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. I disagree on bloat and on little gain. If you insist on changing status quo I would like to call in a vote. Best, Sebastian