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.62) (envelope-from ) id 1I2pRb-0006xu-Tx for garchives@archives.gentoo.org; Mon, 25 Jun 2007 14:21:32 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.0/8.14.0) with SMTP id l5PEKAMs017420; Mon, 25 Jun 2007 14:20:10 GMT Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by robin.gentoo.org (8.14.0/8.14.0) with ESMTP id l5PEHN3x013452 for ; Mon, 25 Jun 2007 14:17:24 GMT Received: from localhost (localhost [127.0.0.1]) by smtp.gentoo.org (Postfix) with ESMTP id 79E526495F for ; Mon, 25 Jun 2007 14:17:23 +0000 (UTC) X-Virus-Scanned: amavisd-new at gentoo.org X-Spam-Score: 0.673 X-Spam-Level: X-Spam-Status: No, score=0.673 required=5.5 tests=[AWL=-0.580, RCVD_NUMERIC_HELO=1.253] Received: from smtp.gentoo.org ([127.0.0.1]) by localhost (smtp.gentoo.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ObKKCWgzBpOt for ; Mon, 25 Jun 2007 14:17:21 +0000 (UTC) Received: from ciao.gmane.org (main.gmane.org [80.91.229.2]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id 7089F64E46 for ; Mon, 25 Jun 2007 14:17:20 +0000 (UTC) Received: from list by ciao.gmane.org with local (Exim 4.43) id 1I2pEr-0005Zj-7o for gentoo-dev@gentoo.org; Mon, 25 Jun 2007 16:08:21 +0200 Received: from 82.153.143.36 ([82.153.143.36]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 25 Jun 2007 16:08:21 +0200 Received: from slong by 82.153.143.36 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 25 Jun 2007 16:08:21 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: gentoo-dev@lists.gentoo.org From: Steve Long Subject: [gentoo-dev] Re: Re: RFC: Unifying the behavior of the doc use flag and document it Date: Mon, 25 Jun 2007 15:07:14 +0100 Message-ID: References: <467D2A04.6080504@gentoo.org> <20070623162942.74635a1d@sheridan.genone.homeip.net> <467D2F72.1020909@gentoo.org> <8cd1ed20706240642l23d9db05g430758fcbc6c6c60@mail.gmail.com> 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: text/plain; charset=us-ascii Content-Transfer-Encoding: 7Bit X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: 82.153.143.36 User-Agent: KNode/0.10.4 Sender: news X-Archives-Salt: 7d6d5438-ca2b-45d1-bff0-43239cadeef5 X-Archives-Hash: b118a06ad16b156249c61f0b82dcfa20 Steve Long wrote: > Kent Fredric wrote: >>> ++ I was only thinking of the programmer:user difference, since code >>> docs tend to pull in a lot of stuff, where as end-user docs are normally >>> supplied in an easier format (eg not dox ;) rebuild-docs as a one-shot >>> flag is great. >>> >>> Would there be a way to control what kind of markup is output (assuming >>> a package supports it)? For example, to specify that files should be for >>> text-only or graphical browser (where both would be the default.) XeTeX >>> -- PS -- PDF is another along those lines. >> >> I can just feel a USE expansion coming on. >> >> DOC="none pdf txt man ps html info all rebuild" sounds like just a >> bunch for starters. >> >> Any votees? >> > Not me, I'm afraid, unless this is the only way to do it.. I agree that > they should only apply to single packages, not across the tree. Although, > if I'm honest, I don't know what that breaks. > Hmm I've been thinking on this a bit more, and I think it does generalise well in user terms. After all, if I want documents in text only format for an installation, it applies to all packages. What concerned me more was 1) whether it would expand to all by default, as other expansions do (not so major with profiles perhaps?) and 2) being able to override if we do want eg html for a package we develop with. But according to ivanm, you can override with package.use e.g. linguas_en_gb so long as you know the prefix (ie doc_). So consider that a positive vote from me :) Though I must stress I want tex in there ;) Useful tip btw: if you have udept emerged, then doing dep -u will tell you _all_ the use vars, including the expanded ones -- gentoo-dev@gentoo.org mailing list