--- hb-working-portage.xml      21 Oct 2007 19:16:11 -0000      1.65
+++ hb-working-portage.xml      1 Nov 2007 00:55:36 -0000
@@ -202,10 +202,11 @@
 </pre>
 
 <p>
-You can enable or disable the <c>doc</c> USE flag either globally in the
-<path>/etc/make.conf</path> file or per package in
-<path>/etc/portage/package.use</path>. The <uri link="?part=2&amp;chap=2">USE
-Flags</uri> chapter covers this aspect in detail.
+The best way of enable the <c>doc</c> USE flag is doing it per package, in
+<path>/etc/portage/package.use</path>, so you get documentation for the packages
+you are interested in. Enable the flag globally is known to give problems with
+circular dependencies. You can read the chapter about <uri
+link="?part=2&amp;chap=2">USE Flags</uri> for more information about them.
 </p>
 
 <p>