Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 145433 - net-mail/dovecot-1.0_rc7 uses the doc use flag to control installation of all documentation
Summary: net-mail/dovecot-1.0_rc7 uses the doc use flag to control installation of all...
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: Normal enhancement (vote)
Assignee: Roy Marples (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-08-28 19:54 UTC by William Hubbs
Modified: 2006-09-05 06:19 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description William Hubbs gentoo-dev 2006-08-28 19:54:49 UTC
The description of the "doc" use flag is as follows:

global use flags (searching: doc)
************************************************************
[-    ] doc - Adds extra documentation (API, Javadoc, etc)

When I upgraded to the latest version of dovecot (1.0_rc7), I was surprised when I found that no documentation at all is installed if the "doc" use flag is not active.

Is there a reason that "doc" for this package controls whether any documentation is installed?
Comment 1 Roy Marples (RETIRED) gentoo-dev 2006-09-03 06:41:15 UTC
(In reply to comment #0)
> Is there a reason that "doc" for this package controls whether any
> documentation is installed?

I couldn't decide what documentation should be included/excluded by the flag so I made it handle all of it.

What documentation (specific files please) would you always expect to be installed?
Comment 2 William Hubbs gentoo-dev 2006-09-05 05:06:58 UTC
In this case, since the package doesn't have an API or seem to have any separate documentation that only developers would be intrested in, I don't feel that it is necessary to use the doc use flag.  All of the documentation should be installed as it was in 1.0_beta8.
Comment 3 Roy Marples (RETIRED) gentoo-dev 2006-09-05 06:09:08 UTC
You would say that doc/{auth-protocol,index,multiaccess,securecoding}.txt are end user documentation then?

I'll allow those to be installed by the doc use flag, but let the others through
Comment 4 Roy Marples (RETIRED) gentoo-dev 2006-09-05 06:19:30 UTC
Fixed