Add section about how to use USE_CURSES, NEED_NCURSES, and

REPLACE_NCURSES.
Unrelated whitespace fix.

1 files changed, 31 insertions, 2 deletions

diff --git a/Packages.txt b/Packages.txt
index c244f65d399..0ee0c3eab85 100644
--- a/Packages.txt
+++ b/Packages.txt
@@ -1,4 +1,4 @@
-# $NetBSD: Packages.txt,v 1.102 2000/07/28 01:40:05 hubertf Exp $
+# $NetBSD: Packages.txt,v 1.103 2000/07/29 10:10:43 wiz Exp $
 ###########################################################################
 
 			==========================
@@ -1341,7 +1341,7 @@ debugging aids.
  9 FAQs & features of the package system
  =======================================
 
- 9.1 Packages using GNU autoconfig
+ 9.1  Packages using GNU autoconfig
  9.2  Other distrib methods than .tar.gz
  9.3  Packages not creating their own subdirectory
  9.4  Custom configuration process
@@ -1360,6 +1360,7 @@ debugging aids.
  9.17 How to handle incrementing versions when fixing an existing package
  9.18 "Could not find bsd.own.mk" - what's wrong?
  9.19 Restricted packages
+ 9.20 Packages using (n)curses
 
 
  9.1 Packages using GNU autoconfig
@@ -1685,6 +1686,34 @@ Please note that the use of NO_PACKAGE, IGNORE, NO_CDROM, or other generic
 make variables to denote restrictions is deprecated, because they
 unconditionally prevent users from generating binary packages!
 
+ 9.20 Packages using (n)curses
+ =============================
+
+Some packages need curses functionality that wasn't present in NetBSD's own
+curses prior to 1.4Y. For packages using such functionality there are some
+variables: If USE_CURSES is set in a package's Makefile, NEED_NCURSES is
+set automatically to YES or NO, depending on whether a dependency on
+ncurses is needed on this system. You can use this variable to e.g. add
+arguments to configure to tell the package whether to use ncurses.
+
+Additionally, you can set REPLACE_NCURSES to some filenames; in each of
+these files, each occurrence of 'ncurses' is replaced by 'curses' if the
+package doesn't need ncurses. You may need this in some cases if ncurses
+are installed, and the package's configure script prefers ncurses.
+
+For example, in mail/mutt, the relevant lines are:
+USE_CURSES=		YES
+REPLACE_NCURSES=	configure configure.in
+[...]
+.include "../../mk/bsd.pkg.mk"
+
+.if defined(NEED_NCURSES) && ${NEED_NCURSES} == "YES"
+CONFIGURE_ARGS+=	--with-curses=${LOCALBASE}
+.endif
+
+Please note that the check for NEED_NCURSES has to be below the
+inclusion of bsd.pkg.mk, since the variable is set there.
+
 
  10 Submitting
  =============