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 1I2SOn-00020d-F1 for garchives@archives.gentoo.org; Sun, 24 Jun 2007 13:45:05 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.0/8.14.0) with SMTP id l5ODi8Vd005002; Sun, 24 Jun 2007 13:44:08 GMT Received: from py-out-1112.google.com (py-out-1112.google.com [64.233.166.182]) by robin.gentoo.org (8.14.0/8.14.0) with ESMTP id l5ODgGBT002778 for ; Sun, 24 Jun 2007 13:42:16 GMT Received: by py-out-1112.google.com with SMTP id a73so710291pye for ; Sun, 24 Jun 2007 06:42:15 -0700 (PDT) DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=bZHL3E9FhfAiHWvFkgk7HUgfalDdrAJnj8cENR12i8PklYUgcuZlGtfmo+lGXcad3YE0R8RDrsIASeWCVYKATXe9AxBZRV+cxiHied74HNu6leSik7uk8Y7bsuomxwywx11q2mxsaLIoxnMbfOiTCcylggSUtMxqkQnTGoSWTV8= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=Y+i+fgTJCh/wOnLphkQbMLrZ2f0SkPaNK++504PbZk2KUGM3D+DV6EILOzRTKSJ9eXi3sHYL0TiUflB8ORmVqqJXrQ7u6bffP81nBRe8/oPOdnYTG7VAIPXM0Mwz7jiLCc7YALXNUfvmEHCAfj7H+9NweCVALcP9imUUy6CXa1w= Received: by 10.65.150.18 with SMTP id c18mr7886551qbo.1182692535153; Sun, 24 Jun 2007 06:42:15 -0700 (PDT) Received: by 10.64.251.15 with HTTP; Sun, 24 Jun 2007 06:42:15 -0700 (PDT) Message-ID: <8cd1ed20706240642l23d9db05g430758fcbc6c6c60@mail.gmail.com> Date: Mon, 25 Jun 2007 01:42:15 +1200 From: "Kent Fredric" To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] Re: RFC: Unifying the behavior of the doc use flag and document it In-Reply-To: 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=ISO-8859-1; format=flowed Content-Transfer-Encoding: quoted-printable Content-Disposition: inline References: <467D2A04.6080504@gentoo.org> <20070623162942.74635a1d@sheridan.genone.homeip.net> <467D2F72.1020909@gentoo.org> X-Archives-Salt: 7d68ca8e-fd72-43b0-8349-1b37f6a88385 X-Archives-Hash: 8c9e1f94d5f79a4f0248ffaa28ad31dd On 6/25/07, Steve Long wrote: > Petteri R=E4ty wrote: > >> Maybe the flag needs to be renamed/split up to clarify it's meaning, > >> it's too generic in it's current form (many people enable it blindly a= nd > >> don't really have any clue what the result is). > >> Like using USE=3Dapidoc for API documentation, USE=3Dextradoc for extr= a > >> user documentation (controlling PDF generation and stuff like that), > >> USE=3Drebuild-docs to replace pregenerated documentation with > >> updated/regenerated versions (like the gtk-doc issue), and so on (don'= t > >> know what other use cases there are for USE=3Ddoc currently). > >> > >> It's a large change, but USE=3Ddoc has been a significant problem for > >> quite a while already (circular deps anyone?) > >> > > > > That does sound like a good idea. > > > ++ 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 fl= ag > 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=3D"none pdf txt man ps html info all rebuild" sounds like just a bunch for starters. Any votees? --=20 Kent ruby -e '[1, 2, 4, 7, 0, 9, 5, 8, 3, 10, 11, 6, 12, 13].each{|x| print "enNOSPicAMreil kdrtf@gma.com"[(2*x)..(2*x+1)]}' -- gentoo-dev@gentoo.org mailing list