Re: [gentoo-dev] *-doc vs USE="doc"

[Alastair Tse <liquidx@gentoo.org>]

[-- Attachment #1: Type: text/plain, Size: 1758 bytes --]

On Sat, 2003-07-12 at 11:25, Spider wrote:
> Well, this is an no-issue issue, from the beginning doc was used to
> differentiate wether to build the (costly, dependencywise and timewise) 
> .ps, pdf. html and other versions of documentation from the original
> templates, actions which required jade, tetex and a lot of cpupower, or
> wether to just install the basic pregenerated documentation.
> 
> This too goes for source-included things like gtk-doc (library
> documentation)
> 
> So, any case that uses "doc" to differentiate manpages or general 
> 

OK, so "doc" is only to separate developer documentation? Is that a fair
definition? If so then I think the description of the useflag should be
modified. Because right now, it is very vague saying "Add Extra
Documentation". 

> To separate devleoper-documentation is a common thing to do, since API's
> tend to change less frequently, so for say java 1.2.*  could well use
> the documentation from any java-1.2 standard + some errata
>
> I'd suggest marking all packages that separate end-user documentation
> with USE="doc" are flawed and should be fixed.  All those who have extra
> developer-centric documentation (api, examples and so on) could well
> have them separated in RDEPEND="doc? (${PN}-api-documentation )" 

That seems reasonable. I just want clarify how we should handle docs. I
guess this is acceptable way. Just wondering why the docs aren't
actually included in the package themselves.

Cheers,
-- 
Alastair 'liquidx' Tse
 >> Gentoo Developer 
 >> http://www.liquidx.net/ | http://dev.gentoo.org/~liquidx/
 >> GPG Key : http://dev.gentoo.org/~liquidx/liquidx_gentoo_org.asc
 >> FingerPrint : 579A 9B0E 43E8 0E40 EE93  BB1C 38CE 1C7B 3907 14F6

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]