Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 292445 - Gentoo Handbook should include a section on ACCEPT_LICENSE / package.license
Summary: Gentoo Handbook should include a section on ACCEPT_LICENSE / package.license
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: nm (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: 288499
  Show dependency tree
 
Reported: 2009-11-08 22:58 UTC by Allen Brooker (AllenJB)
Modified: 2010-03-03 00:38 UTC (History)
8 users (show)

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 Allen Brooker (AllenJB) 2009-11-08 22:58:50 UTC
The Gentoo Handbook should include a section on ACCEPT_LICENSE and related features. I would suggest a new section under "Working with Portage" titled "Licenses".

I would suggest it includes:
- ACCEPT_LICENSE in make.conf
- /etc/portage/package.license
- Where to find specific licenses in the main tree
- How to find out what license a given package uses
- An example of the output given when portage encounters a license which is masked
Comment 1 Vlastimil Babka (Caster) (RETIRED) gentoo-dev 2009-11-09 14:30:39 UTC
*** Bug 292502 has been marked as a duplicate of this bug. ***
Comment 2 Anton Bolshakov 2009-11-11 00:37:11 UTC
------- Comment  #4 From Martin Väth  2009-11-10 22:23:59 0000  [reply] -------

May I please suggest that portage should print a warning concerning the
license if it "forgets" that a package is installed because the license
does not match?

In the above command the warning was printed, but if you had just installed
sun-jdk before as in bug 292639, just an (actually unneeded) dependency is
pulled in, and the user cannot see why this is happening, even worse: He might
not even notice that something is wrong.

I do not understand anyway why a masking of an *installed* package *tacitly*
modifies the dependency tree as if it has not been installed. At least,
a big fat warning should be printed in such a case, generally.
Comment 3 nm (RETIRED) gentoo-dev 2009-11-11 03:06:46 UTC
(In reply to comment #2)

Open a new bug for that and assign it to the Portage team; this bug is for the handbook only.

Comment 4 Vlastimil Babka (Caster) (RETIRED) gentoo-dev 2009-11-11 06:50:52 UTC
Filled as bug 292752
Comment 5 Allen Brooker (AllenJB) 2009-11-14 19:24:54 UTC
I've written a short article on this feature at http://en.gentoo-wiki.com/wiki/Licenses - please feel free to use any of the content I have written (or improve the article on the wiki!)
Comment 6 nm (RETIRED) gentoo-dev 2009-11-30 07:43:33 UTC
Portage team:

Is this even something we can document for the stable version of Portage? My understanding was that ACCEPT_LICENSE is only in 2.2*. If so, this bug will have to be marked RESO LATER.

Otherwise, it might have to be marked RESO CANTFIX without a patch, as I have no clue how the license features work. Patches or some kind of explanatory text that I can drop into the handbook are a must.
Comment 7 Arfrever Frehtes Taifersar Arahesis (RETIRED) gentoo-dev 2009-11-30 12:02:29 UTC
(In reply to comment #6)
> My understanding was that ACCEPT_LICENSE is only in 2.2*.

It's supported also in 2.1.7* which will be stabilized maybe in about 1 month.

> Otherwise, it might have to be marked RESO CANTFIX without a patch, as I have
> no clue how the license features work. Patches or some kind of explanatory
> text that I can drop into the handbook are a must.

ACCEPT_LICENSE is documented in `man make.conf`. package.license is documented in `man portage`. Also see http://www.gentoo.org/proj/en/glep/glep-0023.html .
Comment 8 Vlastimil Babka (Caster) (RETIRED) gentoo-dev 2010-01-27 10:10:23 UTC
So, portage with ACCEPT_LICENSE support went stable...
Comment 9 Blu3 2010-02-14 20:22:44 UTC
portage should emit a sentence about how to 'fix' packages when blocked for licenses. i.e.:  Package blocked because license "GPL" not in ACCEPT_LICENSE.  See make.conf(5) man page for more information.
Comment 10 nm (RETIRED) gentoo-dev 2010-03-03 00:38:25 UTC
I took the time to come up with ACCEPT_LICENSE info for the Portage handbook. I talked about which Portage version supports 'em, where to find 'em, how to set 'em, and more. I also added a bit to the "masked packages" section on dealing with stuff that's license-masked, like Skype.

We should be good to go, so . . . closing.