X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=INSTALL;h=fec266fec1bc15f0a1ad35d8b6f03336389a7b11;hb=aef6681d538d4bd02cfdf9f52aeefec62488efd6;hp=4600641f39f373088908c202ac93e7e5c7374093;hpb=d21ad44bdac29dcfbd1cf10a1918a42c43215b3d;p=ncurses.git diff --git a/INSTALL b/INSTALL index 4600641f..fec266fe 100644 --- a/INSTALL +++ b/INSTALL @@ -1,5 +1,5 @@ ------------------------------------------------------------------------------- --- Copyright 2018-2020,2021 Thomas E. Dickey -- +-- Copyright 2018-2022,2023 Thomas E. Dickey -- -- Copyright 1998-2017,2018 Free Software Foundation, Inc. -- -- -- -- Permission is hereby granted, free of charge, to any person obtaining a -- @@ -26,7 +26,7 @@ -- sale, use or other dealings in this Software without prior written -- -- authorization. -- ------------------------------------------------------------------------------- --- $Id: INSTALL,v 1.236 2021/10/26 07:55:02 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., @@ -477,13 +477,17 @@ CONFIGURE OPTIONS: --disable-root-access Compile with environment restriction, so most file-access is limited - when running via a setuid/setgid application. + when running as root, or via a setuid/setgid application. --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 @@ -806,6 +820,11 @@ CONFIGURE OPTIONS: --enable-xmc-glitch Compile-in support experimental xmc (magic cookie) code. + --with-abi-altered=NUM + Override the displayed (rather than compiled-in) ABI. Only packagers + who have created configurations where the ABI differs from ncurses + should be interested in this option. + --with-abi-version=NUM Override the ABI version, which is used in shared library filenames. Normally this is the same as the release version; some ports have @@ -1009,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 @@ -1156,6 +1175,9 @@ CONFIGURE OPTIONS: Automatic selection is overridden by providing an option-value beginning with "/". + If this option is omitted, the default directory for installing + ".pc" files is ${libdir}/pkgconfig + --with-profile Generate profile-libraries These are named by adding "_p" to the root, e.g., libncurses_p.a @@ -1214,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. @@ -1334,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. @@ -1378,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. @@ -1408,6 +1430,27 @@ COMPATIBILITY WITH OLDER RELEASES: you may encounter when building a system with different versions of ncurses: + 6.4 (Dec 31, 2022) + Interface changes: + + + none + + Added extensions: + + + none + + Added internal functions (other than "_sp" variants): + + + add _nc_free_termtype1 and _nc_free_tparm, for memory-leaks + + Removed internal functions: + + + none + + Modified internal functions: + + + none + 6.3 (Oct 21, 2021) Interface changes: