ncurses 6.4 - patch 20230722

[ncurses.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 8555f738d640c7af19f47c3fc0c7b6c2f9f473fc..fec266fec1bc15f0a1ad35d8b6f03336389a7b11 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -26,7 +26,7 @@
 -- sale, use or other dealings in this Software without prior written        --
 -- authorization.                                                            --
 -------------------------------------------------------------------------------
--- $Id: INSTALL,v 1.241 2023/04/17 08:04:48 tom Exp $
+-- $Id: INSTALL,v 1.247 2023/07/22 17:25:24 tom Exp $
 ---------------------------------------------------------------------
              How to install Ncurses/Terminfo on your system
 ---------------------------------------------------------------------
@@ -444,7 +444,7 @@ CONFIGURE OPTIONS:
                --with-menu-libname=XXX
                --with-panel-libname=XXX
 
-       Rather than renaming them abitrarily, a prefix or suffix is
+       Rather than renaming them arbitrarily, a prefix or suffix is
        recommended.  An "n" prefix provides consistency with ncurses versus
        curses, i.e.,
 
@@ -481,9 +481,13 @@ CONFIGURE OPTIONS:
 
     --disable-root-environ
        Compile with environment restriction, so certain environment variables
-       are not available when running as root, or via a setuid/setgid
-       application.  These are (for example $TERMINFO) those that allow the
-       search path for the terminfo or termcap entry to be customized.
+       are not available when running as root.  These are (for example
+       $TERMINFO) those that allow the search path for the terminfo or termcap
+       entry to be customized.
+
+       Disabling the root environment variables also disables the setuid
+       environment variables by default.  Use the --disable-setuid-environ
+       option to modify this behavior.
 
     --disable-rpath-hack
        Normally the configure script helps link libraries found in unusual
@@ -498,6 +502,16 @@ CONFIGURE OPTIONS:
     --disable-stripping
        Do not strip installed executables.
 
+    --disable-setuid-environ
+       Compile with environment restriction, so certain environment variables
+       are not available when running via a setuid/setgid application.  These
+       are (for example $TERMINFO) those that allow the search path for the
+       terminfo or termcap entry to be customized.
+
+       A setuid/setgid application inherits its environment variables from
+       the current user, in contrast to sudo which may limit the environment
+       variables that ncurses uses.
+
     --disable-tic-depends
        When building shared libraries, normally the tic library is linked to
        depend upon the ncurses library (or equivalently, on the tinfo-library
@@ -1014,7 +1028,7 @@ CONFIGURE OPTIONS:
        See also the --enable-getcap option.
 
     --with-infocmp-path[=XXX]
-       Use this option to override the automatic detection of tic in your
+       Use this option to override the automatic detection of infocmp in your
        $PATH when building fallbacks (see "--with-fallbacks").
 
     --with-install-prefix=XXX
@@ -1222,6 +1236,10 @@ CONFIGURE OPTIONS:
        This is normally chosen automatically based on the type of system
        which you are building on.  We use it for testing the configure script.
 
+    --with-strip-program=XXX
+       When stripping executables during install, use the specified program
+       rather than "strip".
+
     --with-sysmouse
        use FreeBSD sysmouse interface provide mouse support on the console.
 
@@ -1342,7 +1360,8 @@ CONFIGURE OPTIONS:
     --with-xterm-kbs=XXX
        Configure xterm's terminfo entries to use either BS (^H, i.e., ASCII
        backspace) or DEL (^?, or 127).  XXX can be BS (or bs, 8) or DEL
-       (or del, 127).
+       (or del, 127).  If XXX is "auto", the configure script chooses BS or
+       DEL according to platform defaults.
 
        During installation, the makefile and scripts modifies the "xterm+kbs"
        terminfo entry to use this setting.
@@ -1386,11 +1405,6 @@ CONFIGURE OPTIONS:
        programs (e.g., tic).  The test applications will still be built if you
        type "make", though not if you simply do "make install".
 
-    --without-tack
-       Suppress build/install with tack program, if it happens to be
-       in the same build-tree (tack was moved out of the ncurses source-tree
-       in 20070203).
-
     --without-tests
        Tell the configure script to suppress the build of ncurses' test
        programs.