[pkgsrc/trunk]: pkgsrc Document USE_X11 and explain when X11 packages should ...

[jmmv <jmmv%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/1262e13c9a78
branches:  trunk
changeset: 461552:1262e13c9a78
user:      jmmv <jmmv%pkgsrc.org@localhost>
date:      Wed Sep 17 19:04:21 2003 +0000

description:
Document USE_X11 and explain when X11 packages should be placed under LOCALBASE
and when under X11BASE.  Closes PR pkg/21759.

diffstat:

 Packages.txt |  23 +++++++++++++++++------
 1 files changed, 17 insertions(+), 6 deletions(-)

diffs (37 lines):

diff -r 9ddad314d258 -r 1262e13c9a78 Packages.txt
--- a/Packages.txt      Wed Sep 17 18:43:43 2003 +0000
+++ b/Packages.txt      Wed Sep 17 19:04:21 2003 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: Packages.txt,v 1.307 2003/08/30 22:01:36 seb Exp $
+# $NetBSD: Packages.txt,v 1.308 2003/09/17 19:04:21 jmmv Exp $
 ###########################################################################
 
                        ==========================
@@ -1267,11 +1267,22 @@
    ${X11BASE}.
 
  * X11 based pkgs are special in that they may be installed in either
-   X11BASE or LOCALBASE. To install X11 packages in LOCALBASE, simply
-   install the xpkgwedge package (pkgsrc/pkgtools/xpkgwedge).
-   If you need to find includes or libraries installed by a pkg that has
-   USE_IMAKE  or USE_X11BASE in its pkg Makefile, you need to use _both_
-   ${X11BASE} and ${LOCALBASE}.
+   X11BASE or LOCALBASE.
+
+   Usually, X11 packages should be installed under LOCALBASE whenever
+   possible.  Note that you will need to set USE_X11 in them to request
+   the presence of X11 and to get the right compilation flags.
+   
+   Even though, there are some packages that cannot be installed under
+   LOCALBASE: those that come with app-defaults files. These packages are
+   special and they must be placed under X11BASE. To accomplish this,
+   set either USE_X11BASE or USE_IMAKE in your package.
+
+   Some notes: USE_X11 and USE_X11BASE are mutually exclusive. If you need
+   to find includes or libraries installed by a pkg that has USE_IMAKE or
+   USE_X11BASE in its pkg Makefile, you need to use _both_ ${X11BASE} and
+   ${LOCALBASE}. To install all X11 packages in LOCALBASE, simply install
+   the xpkgwedge package (pkgsrc/pkgtools/xpkgwedge).
 
  * ${X11PREFIX} should be used to refer to the installed location of an X11
    package. X11PREFIX will be set to ${X11BASE} if xpkgwedge is not installed,