From df4c94286871c1f3c5e1c491ad98b1e8850d417e Mon Sep 17 00:00:00 2001 From: Dima Dorfman Date: Sat, 2 Jun 2001 03:00:07 +0000 Subject: [PATCH] Explain how to deal with optional dependencies. Submitted by: Mike Meyer --- .../books/porters-handbook/book.sgml | 38 ++++++++++++++++++- .../books/porters-handbook/book.sgml | 38 ++++++++++++++++++- 2 files changed, 74 insertions(+), 2 deletions(-) diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 40215afcd9..4304a01883 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -1,7 +1,7 @@ + + Optional dependencies + + Some large applications can be built in a number of + configurations, adding functionality if one of a number of + libraries or applications is available. Since not all users + want those libraries or applications, the ports system + provides hooks that the port author can use to decide which + configuration should be built. Supporting these properly will + make uses happy, and effectively provide 2 or more ports for the + price of one. + + The easiest of these to use is + WITHOUT_X. If the port can be built both + with and without X support, then it should normally be built + with X support. If WITHOUT_X is defined, + then the version that does not have X support should be + built. + + Various parts of GNOME have such knobs, though they are + slightly more difficult to use. The variables to use in the + Makefile are WANT_* + and HAVE_*. If the application can be + built both with or without one of the dependencies listed + below, then the Makefile should set + WANT_PKG, and should build the version that + uses PKG if HAVE_PKG + is defined. + + The WANT_* variables currently + supported this way are WANT_GLIB, + WANT_GTK, WANT_ESOUND, + WANT_IMLIB, and + WANT_GNOME. + + Building mechanisms diff --git a/en_US.ISO_8859-1/books/porters-handbook/book.sgml b/en_US.ISO_8859-1/books/porters-handbook/book.sgml index 40215afcd9..4304a01883 100644 --- a/en_US.ISO_8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO_8859-1/books/porters-handbook/book.sgml @@ -1,7 +1,7 @@ + + Optional dependencies + + Some large applications can be built in a number of + configurations, adding functionality if one of a number of + libraries or applications is available. Since not all users + want those libraries or applications, the ports system + provides hooks that the port author can use to decide which + configuration should be built. Supporting these properly will + make uses happy, and effectively provide 2 or more ports for the + price of one. + + The easiest of these to use is + WITHOUT_X. If the port can be built both + with and without X support, then it should normally be built + with X support. If WITHOUT_X is defined, + then the version that does not have X support should be + built. + + Various parts of GNOME have such knobs, though they are + slightly more difficult to use. The variables to use in the + Makefile are WANT_* + and HAVE_*. If the application can be + built both with or without one of the dependencies listed + below, then the Makefile should set + WANT_PKG, and should build the version that + uses PKG if HAVE_PKG + is defined. + + The WANT_* variables currently + supported this way are WANT_GLIB, + WANT_GTK, WANT_ESOUND, + WANT_IMLIB, and + WANT_GNOME. + + Building mechanisms