three improvements i would like with the useflag dep usage documentation at : http://www.gentoo.org/doc/en/gentoo-howto.xml 1. explain ternary operator x? (a) : (b) , an example would be: It is possible also specify what dependencies should be used if x useflag is not enabled. You can do this with the ternary operator in the following fashion: gtk2? ( >=x11-libs/gtk+-2 ) : ( =x11-libs/gtk+-1.2* ) The above example shows if "gtk2" useflag is enabled, add >=x11-libs/gtk+-2 to the dependencies, otherwise, if "gtk2" useflag is not enabled, add =x11-libs/gtk+-1.2*. 2. explain the ! operator before the use flags Alternatively, to signify dependencies in the absense of a useflag, you can use the ! symbol before the useflag. An example would be : gtk? ( >=x11-libs/gtk+-2 ) !gtk? ( >=x11-libs/qt-3 ) This would imply if the "gtk" useflag was enabled, add >=x11-libs/gtk+-2 to the dependencies, and if the "gtk" useflag was not enabled, add >=x11-libs/qt-3 to the dependencies. 3. can we change the example in the docs to not depend on >=gnome-base/gnome-1.4 ? Because we shouldn't set a bad example to people depending on this meta package. If people want to depend on gnome, they should use >=gnome-base/gnome-libs-1.4 (for gtk1) or >=gnome-base/libgnome-2 (for gtk2). we don't want to encourage people to start using the gnome meta packages as a dependency. it would be great if you could replace it with another example, like --with-x or something :)
I'll edit the document and make the requested changes.
peesh is gone, assigning back to docs-team
Created attachment 16261 [details, diff] Proposed patch This patch also fixes the non-working ?style=printable. Fixed document is also available on http://dev.gentoo.org/~swift/gentoo-howto.html
Antifa reviewed this one. http://article.gmane.org/gmane.linux.gentoo.documentation/227 Committed.