ncurses 6.0 - patch 20150808

[ncurses.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 23487c7109238bf80d1712af00c661809ab04de2..1ffe13648696e5c03c127c093a83c76589a290e7 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -25,7 +25,7 @@
 -- sale, use or other dealings in this Software without prior written        --
 -- authorization.                                                            --
 -------------------------------------------------------------------------------
 -- sale, use or other dealings in this Software without prior written        --
 -- authorization.                                                            --
 -------------------------------------------------------------------------------

--- $Id: INSTALL,v 1.183 2015/01/17 23:20:46 tom Exp $
+-- $Id: INSTALL,v 1.187 2015/07/16 23:59:08 tom Exp $

 ---------------------------------------------------------------------
              How to install Ncurses/Terminfo on your system
 ---------------------------------------------------------------------
 ---------------------------------------------------------------------
              How to install Ncurses/Terminfo on your system
 ---------------------------------------------------------------------


@@ -546,6 +546,14 @@ SUMMARY OF CONFIGURE OPTIONS:
        compatible with libncursesw 5.4.  None of the interfaces change, but
        applications which have mouse mask mmask_t's must be recompiled.
 
        compatible with libncursesw 5.4.  None of the interfaces change, but
        applications which have mouse mask mmask_t's must be recompiled.
 

+    --enable-ext-putwin
+       Modify the file-format written by putwin() to use printable text rather
+       than binary files, allowing getwin() to read screen dumps written by
+       differently-configured ncurses libraries.  The extended getwin() can
+       still read binary screen dumps from the "same" configuration of
+       ncurses.  This does not change the ABI (the binary interface seen by
+       calling applications).
+

     --enable-getcap
        Use the 4.4BSD getcap code if available, or a bundled version of it to
        fetch termcap entries.  Entries read in this way cannot use (make
     --enable-getcap
        Use the 4.4BSD getcap code if available, or a bundled version of it to
        fetch termcap entries.  Entries read in this way cannot use (make


@@ -840,6 +848,12 @@ SUMMARY OF CONFIGURE OPTIONS:
        automatically chooses an appropriate ".sym" file, which lists the
        symbols which are part of the ABI.
 
        automatically chooses an appropriate ".sym" file, which lists the
        symbols which are part of the ABI.
 

+    --with-extra-suffix[=XXX]
+       Add the given suffix to header- and library-names to simplify
+       installing incompatible ncurses libraries, e.g., those using a
+       different ABI.  The renaming affects the name of the
+       include-subdirectory if --disable-overwrite is given.
+

     --with-fallbacks=XXX
        Specify a list of fallback terminal descriptions which will be
        compiled into the ncurses library.  See CONFIGURING FALLBACK ENTRIES.
     --with-fallbacks=XXX
        Specify a list of fallback terminal descriptions which will be
        compiled into the ncurses library.  See CONFIGURING FALLBACK ENTRIES.


@@ -1130,11 +1144,11 @@ SUMMARY OF CONFIGURE OPTIONS:
        The Solaris, GNU and reportedly some other linkers (ld) accept a
        "--version-script" option which tells the linker to annotate the
        resulting objects with version identifiers.
        The Solaris, GNU and reportedly some other linkers (ld) accept a
        "--version-script" option which tells the linker to annotate the
        resulting objects with version identifiers.

-       
+

        Use "objdump -T" on a library to see the annotations.
 
        Use "objdump -T" on a library to see the annotations.
 

-       The configure script will automatically apply a suitable ".map" file to
-       provide this information for Linux.  Solaris mapfiles differ:
+       The configure script attempts to automatically apply a suitable ".map"
+       file to provide this information for Linux.  Solaris mapfiles differ:

 
        a) comments are not accepted
        b) wildcards are not accepted, except for a special case of "_*".
 
        a) comments are not accepted
        b) wildcards are not accepted, except for a special case of "_*".


@@ -1146,6 +1160,12 @@ SUMMARY OF CONFIGURE OPTIONS:
        several builds, some symbols will be listed in the the ".map" files
        that do not happen to be present in one configuration or another.
 
        several builds, some symbols will be listed in the the ".map" files
        that do not happen to be present in one configuration or another.
 

+       The sample ".map" (and ".sym") files are generated using a set of
+       scripts which build several configurations for each release version,
+       checking to see which of the "_nc_" symbols can be made local.  In
+       addition to the ncurses libraries and programs, the symbols used
+       by the "tack" program are made global.
+

        These sample ".map" files will not cover all possible combinations.
        In some cases, e.g., when using the --with-weak-symbols option, you
        may prefer to use a different ".map" file by setting this option's
        These sample ".map" files will not cover all possible combinations.
        In some cases, e.g., when using the --with-weak-symbols option, you
        may prefer to use a different ".map" file by setting this option's


@@ -1238,6 +1258,9 @@ COMPATIBILITY WITH OLDER VERSIONS OF NCURSES:
     you may encounter when building a system with different versions of
     ncurses:
 
     you may encounter when building a system with different versions of
     ncurses:
 

+    6.0 (??? ??, 2015)
+
+    5.9 (Apr 04, 2011)

     5.8 (Feb 26, 2011)
        Interface changes:
 
     5.8 (Feb 26, 2011)
        Interface changes: