On 25/04/06, Jakub Moc <[EMAIL PROTECTED]> wrote: > Hello here, > > I'd like to see some clarification of intended doc use flag usage, so > that we wouldn't force users to download/install 40+ megs of docs for a > ~3 meg package, with the only reason being that USE=doc is for developer > documentation only. [1]
The handbook states that "doc" is for package documentation. I've never heard of it being restricted to developer docs only, and if that's true, there are many packages which break that policy. As I always understood it, "doc" is there for all optional documentation such as manuals, APIs etc. Non-optional documentation would be things like online docs accessible from within the program (eg. "help" menu items for gui apps), which if missing generate run-time errors. -- [email protected] mailing list
