[gentoo-commits] proj/ufed:master commit in: /

["Sven Eden" <sven.eden@gmx.de>]

commit:     d15c370abf49b4267f9ce51c7a011413e6235e61
Author:     Sven Eden <sven.eden <AT> gmx <DOT> de>
AuthorDate: Tue Feb 19 15:17:38 2013 +0000
Commit:     Sven Eden <sven.eden <AT> gmx <DOT> de>
CommitDate: Tue Feb 19 15:17:38 2013 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/ufed.git;a=commit;h=d15c370a

Fixed local/global section in the man page.

---
 ufed.8.in |   33 ++++++++++++++++-----------------
 1 files changed, 16 insertions(+), 17 deletions(-)

diff --git a/ufed.8.in b/ufed.8.in
index 652f973..523cbf4 100644
--- a/ufed.8.in
+++ b/ufed.8.in
@@ -48,23 +48,22 @@ in @GENTOO_PORTAGE_EPREFIX@/usr/portage/profiles/use.local.desc.
 
 .B What are "global" and "local" USE flags?
 
-From the perspective of any package there is no distinction between "local" and
-"global" flags. A package either listens to a specific flag or it doesn't.
-
-The difference is the description, and maybe the impact of whether a flag is
-set or not. If a package supports a flag that has a global description in
-@GENTOO_PORTAGE_EPREFIX@/usr/portage/profiles/use.desc but does make use of
-the flag differently, then the package maintainer has to add a local
-description to the packages metadata.xml file.
-.br
-The same applies to flags that have no global description, a local one must be
-provided then.
-
-An example would be a package with the USE flag "tiff", that does not only add
-support for the TIFF image format, but changes the output format of the
-program installed. The USE flag then would have a different impact on the
-package than described in the global description; a local description must be
-provided then.
+Global USE flags are called such because they represent functionality that is
+found in a wider variety of packages. For example, the global flag "cjk" is
+about adding / not adding support for Eastern-Asian languages, which affects
+a multitude of various packages. Global flags are described in
+@GENTOO_PORTAGE_EPREFIX@/usr/portage/profiles/use.desc.
+
+Local USE flags are unique package-wise, because the functionality they stand
+for is only found in that particular package and no other. See
+@GENTOO_PORTAGE_EPREFIX@/usr/portage/profiles/use.local.desc for a full, 
+per-package listing of all local USE flags.
+
+It still happens that a flag which is defined as global is also defined as
+local for one or more packages. That is because the general definition of the
+global flag takes on specialized semantics in some particular package. It also
+occurs that multiple packages define a local flag of the same name - the
+meaning of the flag differs, however, for each package.
 
 .B What are "Masked" and "Forced" flags?