Mailing List Archive

Robert Svoboda wrote:

>Hi Gentoo users,
>
>is there a way to enable documentation installation for
>certain package?
>
>I have nodoc feature in make.conf.
>But I'd like to have documentation for certain packages,
>for example mutt.
>
>Is there any USE flag or another option to achieve this?
>
>Thanks,
>Robert
>
>
>
USE="doc" emerge <package>

--
gentoo-user@gentoo.org mailing list

On Thu, 23 Sep 2004 10:40:11 +0200, Robert Svoboda <r080@atlas.cz> wrote:
> is there a way to enable documentation installation for
> certain package?
>
> I have nodoc feature in make.conf.
> But I'd like to have documentation for certain packages,
> for example mutt.
>
> Is there any USE flag or another option to achieve this?

You could set up your variables in /etc/portage/package.use and then
put your packages and their specific USE flags in there. You may find
"man portage" of help explaining it.

--
Ric de France
Ph: +61412945554 (international) or 0412945554 (Australia)
== Do you, uh... Gentoo? Gentoooo-hooo!! ==

--
gentoo-user@gentoo.org mailing list

Ralph wrote:
> Robert Svoboda wrote:
>>is there a way to enable documentation installation for
>>certain package?
>
> USE="doc" emerge <package>

No, never (well, almost never) specify USE flags on the emerge
command line. Add the following line to /etc/portage/package.use
(create it if it doesn't exist yet):

mail-client/mutt doc

Add separate lines for every package for which you want the docs.

-- Remy


Remove underscore and suffix in reply address for a timely response.


--
gentoo-user@gentoo.org mailing list

Ralph wrote:
> Robert Svoboda wrote:
>
>> Hi Gentoo users,
>>
>> is there a way to enable documentation installation for
>> certain package?
>>
>> I have nodoc feature in make.conf.
>> But I'd like to have documentation for certain packages,
>> for example mutt.
>>
>> Is there any USE flag or another option to achieve this?
>>
>> Thanks,
>> Robert
>>
>>
>>
> USE="doc" emerge <package>
>
That's the way, you *can* but shouldn't do it.
The better way is to use
#> mkdir -p /etc/portage
#> echo <category>/<package> doc >> /etc/portage/package.use
#> emerge <package>
where <category> is the part before the first slash in the output of
#> emerge <package> -p

This will use the doc USE flag each time you remerge or upgrade the package
in question without having to remember to set the USE environment variable.
See man portage for details of the files you can put in /etc/portage and
their use.

Greetings,
Felix

Thank you guys for help.

I found this:

...
doc - Adds extra documentation
...

in the use.desc file but it made me thinking that "extra" is
something more than just standard documentation.

Robert

--
gentoo-user@gentoo.org mailing list

begin quote
On Thu, 23 Sep 2004 12:16:19 +0200
Robert Svoboda <r080@atlas.cz> wrote:

> Thank you guys for help.
>
> I found this:
>
> ...
> doc - Adds extra documentation
> ...
>
> in the use.desc file but it made me thinking that "extra" is
> something more than just standard documentation.


it is, USE=doc isn't your normal manpages, readme and so on. its for
API, examples and other more intricate documentation, or for
documentation generation that requires extensive tools installed to work
(tetex/latex and so on)


for FEATURES, I'm not sure there is a way to en/dis-able FEATURES on a
per-package basis. Check "man portage" to make sure though.

//Spider

--
begin .signature
Tortured users / Laughing in pain
See Microsoft KB Article Q265230 for more information.
end

* Ralph <res0r9lm@tampadsl.net> [2004-09-23 10:50]:
> USE="doc" emerge <package>

* Remy Blank <remy.blank_asps@pobox.com> [2004-09-23 11:10]:
> Ralph wrote:
> Add the following line to /etc/portage/package.use
> (create it if it doesn't exist yet):
>
> mail-client/mutt doc

Ok, I have put:

mail-client/mutt doc

into /etc/portage/package.use and emerged mutt, but mutt
manual is still not there. Tried to look in /usr/share/doc/
then over the whole disk. (even tried "USE="doc" emerge mutt")

I'm pretty sure that I've been using mutt manual before the
switch to nodoc feature.

Another thing is, that if I do "emerge -pv mutt" there is no
doc USE flag present...

Thanks,
Robert

--
gentoo-user@gentoo.org mailing list

* Spider <spider@gentoo.org> [2004-09-23 13:20]:
> it is, USE=doc isn't your normal manpages, readme and so on. its for
> API, examples and other more intricate documentation, or for
> documentation generation that requires extensive tools installed to work
> (tetex/latex and so on)

So I understood it right...

> for FEATURES, I'm not sure there is a way to en/dis-able FEATURES on a
> per-package basis. Check "man portage" to make sure though.

I didn't find anything related there.

Thanks,
Robert

--
gentoo-user@gentoo.org mailing list

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Robert Svoboda wrote:
| * Ralph <res0r9lm@tampadsl.net> [2004-09-23 10:50]:
|
|>USE="doc" emerge <package>
|
|
| * Remy Blank <remy.blank_asps@pobox.com> [2004-09-23 11:10]:
|
|>Ralph wrote:
|>Add the following line to /etc/portage/package.use
|>(create it if it doesn't exist yet):
|>
|>mail-client/mutt doc
|
| Ok, I have put:
|
| mail-client/mutt doc

This is pointless, since mutt doesn't use a doc USE flag. Even if it
did, as Spider pointed out, the doc USE flag isn't for your normal
everyday docs, but rather for things such as library API's and docs that
require latex or tetex, etc.

| into /etc/portage/package.use and emerged mutt, but mutt
| manual is still not there. Tried to look in /usr/share/doc/
| then over the whole disk. (even tried "USE="doc" emerge mutt")

The only way you can get the mutt manual is by manually doing:

# FEATURES="-nodoc" emerge mutt

since portage does support per-package FEATURES at this time.

| I'm pretty sure that I've been using mutt manual before the
| switch to nodoc feature.
|
| Another thing is, that if I do "emerge -pv mutt" there is no
| doc USE flag present...

See my first sentence.

HTH
- --
10.0 times 0.1 is hardly ever 1.0.

Aaron Walker - Gentoo Developer [ Gentoo/BSD / forensics herd ]
ka0ttic@gentoo.org http://dev.gentoo.org/~ka0ttic/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.6 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFBUvDDC3poscuANHARArOdAJ91of9OutDw2UuW1CZXcZt9Jr3sOwCg6nMF
0bhxMv4KnCSk9EZrm7QN5no=
=WpUV
-----END PGP SIGNATURE-----

--
gentoo-user@gentoo.org mailing list

* Aaron Walker <ka0ttic@gentoo.org> [2004-09-23 18:00]:
> | mail-client/mutt doc
>
> This is pointless, since mutt doesn't use a doc USE flag. Even if it
> did, as Spider pointed out, the doc USE flag isn't for your normal
> everyday docs, but rather for things such as library API's and docs that
> require latex or tetex, etc.

yes, I understand this, see my other post in this thread :-)

> The only way you can get the mutt manual is by manually doing:
>
> # FEATURES="-nodoc" emerge mutt
>
> since portage does support per-package FEATURES at this time.

thank you, this is what I was looking for

Robert

--
gentoo-user@gentoo.org mailing list