From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by nuthatch.gentoo.org with esmtp (Exim 4.50) id 1EfalH-0002rC-M8 for garchives@archives.gentoo.org; Fri, 25 Nov 2005 10:25:00 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.5/8.13.5) with SMTP id jAPANhl6023982; Fri, 25 Nov 2005 10:23:43 GMT Received: from nproxy.gmail.com (nproxy.gmail.com [64.233.182.203]) by robin.gentoo.org (8.13.5/8.13.5) with ESMTP id jAPALLJ4022697 for ; Fri, 25 Nov 2005 10:21:21 GMT Received: by nproxy.gmail.com with SMTP id q29so339901nfc for ; Fri, 25 Nov 2005 02:21:20 -0800 (PST) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:references; b=TK+6J1/Jx0YWvfXXdphFD8BrH89H+ITGmq4WuRwKs3FEeG+8iSyGivpoe6KAj31nquBY3TclRr19u0Wa0LzlUTTCMqU9u/UOjO+BpTQ2luei7zYoZloQcarzZ/0kVrBwbAu5X8Ki5sek6OkOg9kL/XIRblPDKQzIXNcRwT2v8Eg= Received: by 10.48.211.11 with SMTP id j11mr184779nfg; Fri, 25 Nov 2005 02:21:20 -0800 (PST) Received: by 10.48.255.16 with HTTP; Fri, 25 Nov 2005 02:21:20 -0800 (PST) Message-ID: <41b037ed0511250221v43808415hf0b77b50b05c1624@mail.gmail.com> Date: Fri, 25 Nov 2005 11:21:20 +0100 From: Alexandre Buisse To: gentoo-dev@lists.gentoo.org Subject: Re: Re[2]: [gentoo-dev] manpages that requires dependencies In-Reply-To: <484811244.20051125081301@gentoo.org> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="----=_Part_10948_325589.1132914080449" References: <200511250049.50833@enterprise.flameeyes.is-a-geek.org> <20051124235828.61cdacd0@snowdrop.home> <484811244.20051125081301@gentoo.org> X-Archives-Salt: 2940c319-e24c-45c2-82e2-46e834b861cf X-Archives-Hash: d8dc7c91e62defdb6c1103dda099fb2a ------=_Part_10948_325589.1132914080449 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline On 11/25/05, Jakub Moc wrote: > > > 25.11.2005, 0:58:28, Ciaran McCreesh wrote: > > > On Fri, 25 Nov 2005 00:49:23 +0100 "Diego 'Flameeyes' Petteno" > > wrote: > > | Hi everybody, a little question that I'd like to be answered (so that > > | we can make it a sort of rule). > > | How should manpages that are generated be managed? > > | > > | The common sense and looking to other ebuilds would say to always > > | build man pages, but when it asks me to install something like > > | docbook-sgml-utils, I'm tempted not to do that ;) > > > man pages can't be considered optional (despite what RMS says). They're > > not fancy extra HTML API documentation, they're core, so they don't get > > a USE flag. > > > Of course, if FEATURES were in the USE expand list, you could use > > ! features_noman ? ( ) ... > > That is all fine and dandy, but if you search bugzilla for USE=3Ddoc rela= ted > bugs, you might think twice before adding yet another inevitably broken > thing > to portage. docbook-sgml-utils & co. is extremely fragile and buggy thing= . Actually, every automated text generation tool seems to be extremely fragil= e and buggy, see gtkdoc for instance, which also regularly breaks USE=3Ddoc. About manpages, I agree that they are non-optional and should be provided all the time, which leads us straight to the solution : have the maintainer/ebuild writer generate once the manpages (they shouldn't depend on anything on the host machine, right ?) and provide them either directly in the portage tree, as many are under the 20K limit, or as a tarball in distfiles. If the developer hasn't docbok-sgml-utils and doesn't want to pollute his system with it, he could ask text-markup, for instance, to generate the manpages for him. Of course, this doesn't solve the problem of manpages whose content is not the same everywhere (but are there some of these ? Or may be all of them ar= e and I completely missed the point of this thread ?) Regards, Alexandre ------=_Part_10948_325589.1132914080449 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline On 11/25/05, Jakub Moc <jakub@gentoo.org> wrote:

25.11.2005, 0:58:28, Ciaran McCreesh wrote:

> On Fri, 25 Nov = 2005 00:49:23 +0100 "Diego 'Flameeyes' Petteno"
> <flameeyes@gentoo.org> wrote:
> | Hi everybody, a little question that I'd like to be answered (so tha= t
> | we can make it a sort of rule).
> | How should manpages t= hat are generated be managed?
> |
> | The common sense and look= ing to other ebuilds would say to always
> | build man pages, but when it asks me to install something like> | docbook-sgml-utils, I'm tempted not to do that ;)

> man = pages can't be considered optional (despite what RMS says). They're
> not fancy extra HTML API documentation, they're core, so they don't ge= t
> a USE flag.

> Of course, if FEATURES were in the USE ex= pand list, you could use
> ! features_noman ? ( ) ...

That is = all fine and dandy, but if you search bugzilla for USE=3Ddoc related
bugs, you might think twice before adding yet another inevitably broken= thing
to portage. docbook-sgml-utils & co. is extremely fragile and= buggy thing.

Actually, every automated text generation tool seems to be extremely fragile and buggy, see gtkdoc for instance, which also regularly breaks USE=3Ddoc.

About manpages, I agree that they are non-optional and should be provided all the time, which leads us straight to the solution : have the maintainer/ebuild writer generate once the manpages (they shouldn't depend on anything on the host machine, right ?) and provide them either directly in the portage tree, as many are under the 20K limit, or as a tarball in distfiles. If the developer hasn't docbok-sgml-utils and doesn't want to pollute his system with it, he could ask text-markup, for instance, to generate the manpages for him.


Of course, this doesn't solve the problem of manpages whose content is not the same everywhere (but are there some of these ? Or may be all of them are and I completely missed the point of this thread ?)

Regards,
Alexandre
------=_Part_10948_325589.1132914080449-- -- gentoo-dev@gentoo.org mailing list