[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Joshua Saddler (nightmorph)]

nightmorph    08/12/24 07:07:48

  Modified:             hb-working-portage.xml
  Log:
  users shouldn't try running ebuild foo digest anyway. digests haven't been used in a year, ever since the tree was converted to manifest2. the correct command is ebuild foo manifest, so fixed in the example of what not to do.

Revision  Changes    Path
1.72                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.72&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.72&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.71&r2=1.72

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.71
retrieving revision 1.72
diff -u -r1.71 -r1.72
--- hb-working-portage.xml	1 Mar 2008 07:16:57 -0000	1.71
+++ hb-working-portage.xml	24 Dec 2008 07:07:48 -0000	1.72
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.71 2008/03/01 07:16:57 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.72 2008/12/24 07:07:48 nightmorph Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 maintain the software on his system.
 </abstract>
 
-<version>1.64</version>
-<date>2008-02-29</date>
+<version>1.65</version>
+<date>2008-12-23</date>
 
 <section>
 <title>Welcome to Portage</title>
@@ -647,7 +647,7 @@
 
 <p>
 When the digest verification fails, do <e>not</e> try to re-digest the package
-yourself. Running <c>ebuild foo digest</c> will not fix the problem; it will
+yourself. Running <c>ebuild foo manifest</c> will not fix the problem; it will
 almost certainly make it worse!
 </p>
 

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Joshua Saddler (nightmorph)]

nightmorph    10/02/13 20:54:08

  Modified:             hb-working-portage.xml
  Log:
  Some updates for the Portage handbook: one from IRC (thanks integer) on the kde-meta package, and the rest from me for outdated packages and new output.

Revision  Changes    Path
1.73                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.73&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.73&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.72&r2=1.73

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -r1.72 -r1.73
--- hb-working-portage.xml	24 Dec 2008 07:07:48 -0000	1.72
+++ hb-working-portage.xml	13 Feb 2010 20:54:07 -0000	1.73
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.72 2008/12/24 07:07:48 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.73 2010/02/13 20:54:07 nightmorph Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 maintain the software on his system.
 </abstract>
 
-<version>1.65</version>
-<date>2008-12-23</date>
+<version>1.66</version>
+<date>2010-02-13</date>
 
 <section>
 <title>Welcome to Portage</title>
@@ -327,7 +327,7 @@
 
 <p>
 Some packages in the Portage tree don't have any real content but are used to
-install a collection of packages. For instance, the <c>kde</c> package will
+install a collection of packages. For instance, the <c>kde-meta</c> package will
 install a complete KDE environment on your system by pulling in various
 KDE-related packages as dependencies.
 </p>
@@ -448,6 +448,12 @@
 </p>
 
 <p>
+While recent versions of Portage are smart enough to work around minor blockages
+without user intervention, occasionally you will need to fix it yourself, as
+explained below.
+</p>
+
+<p>
 To fix a blockage, you can choose to not install the package or unmerge the
 conflicting package first. In the given example, you can opt not to install
 <c>postfix</c> or to remove <c>ssmtp</c> first.
@@ -455,7 +461,7 @@
 
 <p>
 You may also see blocking packages with specific atoms, such as
-<b>&lt;</b>media-video/mplayer-bin-1.0_rc1-r2. In this case, updating to a more
+<b>&lt;</b>media-video/mplayer-1.0_rc1-r2. In this case, updating to a more
 recent version of the blocking package would remove the block.
 </p>
 
@@ -549,11 +555,27 @@
 <body>
 
 <pre caption="Portage warning about ambiguous ebuild names">
-!!! The short ebuild name "aterm" is ambiguous.  Please specify
-!!! one of the following fully-qualified ebuild names instead:
+[ Results for search key : listen ]
+[ Applications found : 2 ]
+
+*  dev-tinyos/listen [ Masked ]
+      Latest version available: 1.1.15
+      Latest version installed: [ Not Installed ]
+      Size of files: 10,032 kB
+      Homepage:      http://www.tinyos.net/
+      Description:   Raw listen for TinyOS
+      License:       BSD
+
+*  media-sound/listen [ Masked ]
+      Latest version available: 0.6.3
+      Latest version installed: [ Not Installed ]
+      Size of files: 859 kB
+      Homepage:      http://www.listen-project.org
+      Description:   A Music player and management for GNOME
+      License:       GPL-2
 
-    dev-libs/aterm
-    x11-terms/aterm
+!!! The short ebuild name "listen" is ambiguous. Please specify
+!!! one of the above fully-qualified ebuild names instead.
 </pre>
 
 <p>

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Joshua Saddler (nightmorph)]

nightmorph    10/03/03 00:36:42

  Modified:             hb-working-portage.xml
  Log:
  Wrote some stuff on ACCEPT_LICENSE, prompted by bug 292445

Revision  Changes    Path
1.74                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.74&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.74&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.73&r2=1.74

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.73
retrieving revision 1.74
diff -u -r1.73 -r1.74
--- hb-working-portage.xml	13 Feb 2010 20:54:07 -0000	1.73
+++ hb-working-portage.xml	3 Mar 2010 00:36:42 -0000	1.74
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.73 2010/02/13 20:54:07 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.74 2010/03/03 00:36:42 nightmorph Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 maintain the software on his system.
 </abstract>
 
-<version>1.66</version>
-<date>2010-02-13</date>
+<version>1.67</version>
+<date>2010-03-02</date>
 
 <section>
 <title>Welcome to Portage</title>
@@ -370,6 +370,96 @@
 </body>
 </subsection>
 </section>
+<section id="license">
+<title>Licenses</title>
+<subsection>
+<body>
+
+<p>
+Beginning with Portage version 2.1.7, you can accept or reject software
+installation based on its license. All packages in the tree contain a
+<c>LICENSE</c> entry in their ebuilds. Running <c>emerge --search
+packagename</c> will tell you the package's license.
+</p>
+
+<p>
+By default, Portage permits all licenses, except End User License Agreements
+(EULAs) that require reading and signing an acceptance agreement.
+</p>
+
+<p>
+The variable that controls permitted licenses is <c>ACCEPT_LICENSE</c>, which
+can be set in <path>/etc/make.conf</path>:
+</p>
+
+<pre caption="Default ACCEPT_LICENSE in /etc/make.conf">
+ACCEPT_LICENSE="* -@EULA"
+</pre>
+
+<p>
+With this configuration, packages that require interaction during installation
+to approve their EULA <e>will not</e> be installed. Packages without an EULA
+<e>will</e> be installed.
+</p>
+
+<p>
+You can set <c>ACCEPT_LICENSE</c> globally in <path>/etc/make.conf</path>, or
+you can specify it on a per-package basis in
+<path>/etc/portage/package.license</path>.
+</p>
+
+<p>
+For example, if you want to allow the <c>truecrypt-2.7</c> license for
+<c>app-crypt/truecrypt</c>, add the following to
+<path>/etc/portage/package.license</path>:
+</p>
+
+<pre caption="Specifying a truecrypt license in package.license">
+app-crypt/truecrypt truecrypt-2.7
+</pre>
+
+<p>
+This permits installation of truecrypt versions that have the
+<c>truecrypt-2.7</c> license, but not versions with the <c>truecrypt-2.8</c>
+license.
+</p>
+
+<impo>
+Licenses are stored in <path>/usr/portage/licenses</path>, and license groups
+are kept in <path>/usr/portage/license_groups</path>. The first entry of each
+line in CAPITAL letters is the name of the license group, and every entry after
+that is an individual license.
+</impo>
+
+<p>
+License groups defined in <c>ACCEPT_LICENSE</c> are prefixed with an <b>@</b>
+sign. Here's an example of a system that globally permits the GPL-compatible
+license group, as well as a few other groups and individual licenses:
+</p>
+
+<pre caption="ACCEPT_LICENSE in /etc/make.conf">
+ACCEPT_LICENSE="@GPL-COMPATIBLE @OSI-APPROVED @EULA atheros-hal BitstreamVera"
+</pre>
+
+<p>
+If you want only free software and documentation on your system, you might use
+the following setup:
+</p>
+
+<pre caption="Use only free licenses">
+ACCEPT_LICENSE="-* @FREE"
+</pre>
+
+<p>
+In this case, "free" is mostly defined by the <uri
+link="http://www.gnu.org/philosophy/free-sw.html">FSF</uri> and <uri
+link="http://www.opensource.org/docs/osd">OSI</uri>. Any package whose license
+does not meet these requirements will not be installed on your system.
+</p>
+
+</body>
+</subsection>
+</section>
 <section>
 <title>When Portage is Complaining...</title>
 <subsection>
@@ -491,6 +581,7 @@
 - dev-util/cvsd-1.0.2 (masked by: <i>missing keyword</i>)
 - games-fps/unreal-tournament-451 (masked by: <i>package.mask</i>)
 - sys-libs/glibc-2.3.2-r11 (masked by: <i>profile</i>)
+- net-im/skype-2.1.0.81 (masked by: skype-eula <i>license</i>(s))
 </pre>
 
 <p>
@@ -525,6 +616,13 @@
     profile. The application might break your system if you installed it or is
     just not compatible with the profile you use.
   </li>
+  <li>
+    <b>license</b> means that the package's license is not compatible with your
+    <c>ACCEPT_LICENSE</c> setting. You must explicitly permit its license or
+    license group by setting it in <path>/etc/make.conf</path> or in
+    <path>/etc/portage/package.license</path>. Refer to <uri
+    link="#license">Licenses</uri> to learn how licenses work.
+  </li>
 </ul>
 
 </body>

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Joshua Saddler (nightmorph)]

nightmorph    10/10/30 01:54:20

  Modified:             hb-working-portage.xml
  Log:
  Update license_group location, bug 343279

Revision  Changes    Path
1.75                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.75&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.75&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.74&r2=1.75

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.74
retrieving revision 1.75
diff -u -r1.74 -r1.75
--- hb-working-portage.xml	3 Mar 2010 00:36:42 -0000	1.74
+++ hb-working-portage.xml	30 Oct 2010 01:54:20 -0000	1.75
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.74 2010/03/03 00:36:42 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.75 2010/10/30 01:54:20 nightmorph Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 maintain the software on his system.
 </abstract>
 
-<version>1.67</version>
-<date>2010-03-02</date>
+<version>2</version>
+<date>2010-10-29</date>
 
 <section>
 <title>Welcome to Portage</title>
@@ -426,9 +426,9 @@
 
 <impo>
 Licenses are stored in <path>/usr/portage/licenses</path>, and license groups
-are kept in <path>/usr/portage/license_groups</path>. The first entry of each
-line in CAPITAL letters is the name of the license group, and every entry after
-that is an individual license.
+are kept in <path>/usr/portage/profiles/license_groups</path>. The first entry
+of each line in CAPITAL letters is the name of the license group, and every
+entry after that is an individual license.
 </impo>
 
 <p>

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Sven Vermeulen (swift)]

swift       11/08/12 19:24:18

  Modified:             hb-working-portage.xml
  Log:
  Fix bug #326543 - Inform users about USE flag dependency error/warning by portage, thanks to Randy Curry for reporting

Revision  Changes    Path
1.76                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.76&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.76&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.75&r2=1.76

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.75
retrieving revision 1.76
diff -u -r1.75 -r1.76
--- hb-working-portage.xml	30 Oct 2010 01:54:20 -0000	1.75
+++ hb-working-portage.xml	12 Aug 2011 19:24:18 -0000	1.76
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.75 2010/10/30 01:54:20 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.76 2011/08/12 19:24:18 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 maintain the software on his system.
 </abstract>
 
-<version>2</version>
-<date>2010-10-29</date>
+<version>3</version>
+<date>2011-08-12</date>
 
 <section>
 <title>Welcome to Portage</title>
@@ -627,6 +627,45 @@
 
 </body>
 </subsection>
+<subsection id="USEdependency">
+<title>Necessary USE Flag Changes</title>
+<body>
+
+<pre caption="Portage warning about USE flag change requirement">
+The following USE changes are necessary to proceed:
+#required by app-text/happypackage-2.0, required by happypackage (argument)
+>=app-text/feelings-1.0.0 test
+</pre>
+
+<p>
+The error message might also be displayed as follows, if <c>--autounmask</c>
+isn't set:
+</p>
+
+<pre caption="Portage error about USE flag change requirement">
+emerge: there are no ebuilds built with USE flags to satisfy "app-text/feelings[test]".
+!!! One of the following packages is required to complete your request:
+- app-text/feelings-1.0.0 (Change USE: +test)
+(dependency required by "app-text/happypackage-2.0" [ebuild])
+(dependency required by "happypackage" [argument])
+</pre>
+
+<p>
+Such warning or error occurs when you want to install a package which not only
+depends on another package, but also requires that that package is built with a
+particular USE flag (or set of USE flags). In the given example, the package
+<c>app-text/feelings</c> needs to be built with <c>USE="test"</c>, but this USE
+flag is not set on the system.
+</p>
+
+<p>
+To resolve this, either add the requested USE flag to your global USE flags in
+<path>/etc/make.conf</path>, or set it for the specific package in
+<path>/etc/portage/package.use</path>.
+</p>
+
+</body>
+</subsection>
 <subsection id="missingdependencies">
 <title>Missing Dependencies</title>
 <body>

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Sven Vermeulen (swift)]

swift       11/10/13 16:58:14

  Modified:             hb-working-portage.xml
  Log:
  Add information on --with-bdeps as per discussion on gentoo-dev

Revision  Changes    Path
1.77                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.77&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.77&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.76&r2=1.77

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.76
retrieving revision 1.77
diff -u -r1.76 -r1.77
--- hb-working-portage.xml	12 Aug 2011 19:24:18 -0000	1.76
+++ hb-working-portage.xml	13 Oct 2011 16:58:14 -0000	1.77
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.76 2011/08/12 19:24:18 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.77 2011/10/13 16:58:14 swift Exp $ -->
 
 <sections>
 
@@ -294,15 +294,27 @@
 installed. However, it will only verify the versions for the applications you
 have <e>explicitly</e> installed (the applications listed in
 <path>/var/lib/portage/world</path>) - it does not thoroughly check their
-dependencies. If you want to update <e>every single package</e> on your system,
+dependencies. If you want to update the dependencies of those packages as well,
 add the <c>--deep</c> argument:
 </p>
 
-<pre caption="Updating your entire system">
+<pre caption="Updating your system with dependencies">
 # <i>emerge --update --deep world</i>
 </pre>
 
 <p>
+Still, this doesn't mean <e>all packages</e>: some packages on your system are
+needed during the compile and build process of packages, but once that package
+is installed, these dependencies are no longer required. Portage calls those
+<e>build dependencies</e>. To include those in an update cycle, add
+<c>--with-bdeps=y</c>:
+</p>
+
+<pre caption="Updating your entire system">
+# <i>emerge --update --deep --with-bdeps=y world</i>
+</pre>
+
+<p>
 Since security updates also happen in packages you have not explicitly installed
 on your system (but that are pulled in as dependencies of other programs), it 
 is recommended to run this command once in a while. 
@@ -316,7 +328,7 @@
 </p>
 
 <pre caption="Performing a full update">
-# <i>emerge --update --deep --newuse world</i>
+# <i>emerge --update --deep --with-bdeps=y --newuse world</i>
 </pre>
 
 </body>

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Sven Vermeulen (swift)]

swift       12/05/22 18:40:06

  Modified:             hb-working-portage.xml
  Log:
  Fix bug #414723 - Use new style virtual explanation. Thanks to Chema Alonso for the patch.

Revision  Changes    Path
1.79                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.79&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.79&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.78&r2=1.79

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.78
retrieving revision 1.79
diff -u -r1.78 -r1.79
--- hb-working-portage.xml	26 Oct 2011 19:46:19 -0000	1.78
+++ hb-working-portage.xml	22 May 2012 18:40:06 -0000	1.79
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.78 2011/10/26 19:46:19 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.79 2012/05/22 18:40:06 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 maintain the software on his system.
 </abstract>
 
-<version>4</version>
-<date>2011-10-26</date>
+<version>5</version>
+<date>2012-05-22</date>
 
 <section>
 <title>Welcome to Portage</title>
@@ -508,8 +508,9 @@
 are all system loggers. Applications that rely on the availability of "a system
 logger" cannot depend on, for instance, <c>metalogd</c>, as the other system
 loggers are as good a choice as any. Portage allows for <e>virtuals</e>: each
-system logger provides <c>virtual/syslog</c> so that applications can depend on
-<c>virtual/syslog</c>.
+system logger is listed as a provider of the logging service in the
+<c>logger</c> virtual package of the <c>virtual</c> category, so that
+applications can depend on the <c>virtual/logger</c> package.
 </p>
 
 <p>

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Sven Vermeulen (swift)]

swift       13/08/01 19:12:51

  Modified:             hb-working-portage.xml
  Log:
  Fix bug #479386 - Update ACCEPT_LICENSE example, thanks to Ulrich Muller for the feedback and suggestions

Revision  Changes    Path
1.82                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.82&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.82&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.81&r2=1.82

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.81
retrieving revision 1.82
diff -u -r1.81 -r1.82
--- hb-working-portage.xml	15 Aug 2012 07:20:36 -0000	1.81
+++ hb-working-portage.xml	1 Aug 2013 19:12:51 -0000	1.82
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.81 2012/08/15 07:20:36 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.82 2013/08/01 19:12:51 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 maintain the software on his system.
 </abstract>
 
-<version>7</version>
-<date>2012-08-15</date>
+<version>8</version>
+<date>2013-08-01</date>
 
 <section>
 <title>Welcome to Portage</title>
@@ -410,17 +410,18 @@
 
 <p>
 The variable that controls permitted licenses is <c>ACCEPT_LICENSE</c>, which
-can be set in <path>/etc/portage/make.conf</path>:
+can be set in <path>/etc/portage/make.conf</path>. In the next example, this
+default value is shown:
 </p>
 
-<pre caption="Default ACCEPT_LICENSE in /etc/portage/make.conf">
+<pre caption="Setting ACCEPT_LICENSE in /etc/portage/make.conf">
 ACCEPT_LICENSE="* -@EULA"
 </pre>
 
 <p>
 With this configuration, packages that require interaction during installation
-to approve their EULA <e>will not</e> be installed. Packages without an EULA
-<e>will</e> be installed.
+to approve their EULA <e>will not</e> be installable. Packages without an EULA
+<e>will</e> be installable.
 </p>
 
 <p>
@@ -454,28 +455,19 @@
 
 <p>
 License groups defined in <c>ACCEPT_LICENSE</c> are prefixed with an <b>@</b>
-sign. Here's an example of a system that globally permits the GPL-compatible
-license group, as well as a few other groups and individual licenses:
+sign. Here's an example of a system that globally permits the free software (and
+documentation) license group, as well as a few other individual licenses:
 </p>
 
 <pre caption="ACCEPT_LICENSE in /etc/portage/make.conf">
-ACCEPT_LICENSE="@GPL-COMPATIBLE @OSI-APPROVED @EULA atheros-hal BitstreamVera"
-</pre>
-
-<p>
-If you want only free software and documentation on your system, you might use
-the following setup:
-</p>
-
-<pre caption="Use only free licenses">
-ACCEPT_LICENSE="-* @FREE"
+ACCEPT_LICENSE="-* @FREE atheros-hal BitstreamVera"
 </pre>
 
 <p>
 In this case, "free" is mostly defined by the <uri
 link="http://www.gnu.org/philosophy/free-sw.html">FSF</uri> and <uri
 link="http://www.opensource.org/docs/osd">OSI</uri>. Any package whose license
-does not meet these requirements will not be installed on your system.
+does not meet these requirements will not be installable on your system.
 </p>
 
 </body>

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Sven Vermeulen (swift)]

swift       13/08/01 21:00:02

  Modified:             hb-working-portage.xml
  Log:
  Align ACCEPT_LICENSE examples with make.conf.examples - bug #479386

Revision  Changes    Path
1.83                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.83&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.83&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.82&r2=1.83

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.82
retrieving revision 1.83
diff -u -r1.82 -r1.83
--- hb-working-portage.xml	1 Aug 2013 19:12:51 -0000	1.82
+++ hb-working-portage.xml	1 Aug 2013 21:00:02 -0000	1.83
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.82 2013/08/01 19:12:51 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.83 2013/08/01 21:00:02 swift Exp $ -->
 
 <sections>
 
@@ -13,7 +13,7 @@
 maintain the software on his system.
 </abstract>
 
-<version>8</version>
+<version>9</version>
 <date>2013-08-01</date>
 
 <section>
@@ -455,12 +455,14 @@
 
 <p>
 License groups defined in <c>ACCEPT_LICENSE</c> are prefixed with an <b>@</b>
-sign. Here's an example of a system that globally permits the free software (and
-documentation) license group, as well as a few other individual licenses:
+sign. A commonly requested setting is to only allow the installation of free
+software and documentation. To accomplish this, we can remove all currently
+accepted licenses (using <c>-*</c>) and then only allow the licenses in the
+<c>FREE</c> group as follows:
 </p>
 
-<pre caption="ACCEPT_LICENSE in /etc/portage/make.conf">
-ACCEPT_LICENSE="-* @FREE atheros-hal BitstreamVera"
+<pre caption="Only allowing free software and documentation licenses in /etc/portage/make.conf">
+ACCEPT_LICENSE="-* @FREE"
 </pre>
 
 <p>

[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml

[Sven Vermeulen (swift)]

swift       13/09/17 07:25:28

  Modified:             hb-working-portage.xml
  Log:
  Gentoolkit guide moved to wiki

Revision  Changes    Path
1.84                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.84&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.84&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.83&r2=1.84

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.83
retrieving revision 1.84
diff -u -r1.83 -r1.84
--- hb-working-portage.xml	1 Aug 2013 21:00:02 -0000	1.83
+++ hb-working-portage.xml	17 Sep 2013 07:25:28 -0000	1.84
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.83 2013/08/01 21:00:02 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.84 2013/09/17 07:25:28 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 maintain the software on his system.
 </abstract>
 
-<version>9</version>
-<date>2013-08-01</date>
+<version>10</version>
+<date>2013-09-17</date>
 
 <section>
 <title>Welcome to Portage</title>
@@ -223,7 +223,7 @@
 subdirectory named after the package under the <path>/usr/share/doc</path>
 directory. You can also list all installed files with the <c>equery</c> tool
 which is part of the <c>app-portage/gentoolkit</c> <uri
-link="/doc/en/gentoolkit.xml">package</uri>.
+link="https://wiki.gentoo.org/wiki/Gentoolkit">package</uri>.
 </p>
 
 <pre caption="Locating package documentation">