X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=INSTALL;h=e338dc73d1853a487808aaa37778e7877c91734b;hp=7917e299abae0beff72f82b374bd27531afe5482;hb=1c2ec25b8186b7973aeb06ec4da6b63656e12f7d;hpb=60014650d5e3f088e2d5e8835925cce96db00c33

diff --git a/INSTALL b/INSTALL
index 7917e299..e338dc73 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,5 +1,5 @@
 -------------------------------------------------------------------------------
--- Copyright (c) 1998-2005,2006 Free Software Foundation, Inc.               --
+-- Copyright (c) 1998-2006,2008 Free Software Foundation, Inc.               --
 --                                                                           --
 -- Permission is hereby granted, free of charge, to any person obtaining a   --
 -- copy of this software and associated documentation files (the             --
@@ -25,7 +25,7 @@
 -- sale, use or other dealings in this Software without prior written        --
 -- authorization.                                                            --
 -------------------------------------------------------------------------------
--- $Id: INSTALL,v 1.124 2008/03/29 18:07:32 tom Exp $
+-- $Id: INSTALL,v 1.129 2008/08/23 20:02:46 tom Exp $
 ---------------------------------------------------------------------
              How to install Ncurses/Terminfo on your system
 ---------------------------------------------------------------------
@@ -572,6 +572,13 @@ SUMMARY OF CONFIGURE OPTIONS:
     --enable-warnings
 	Turn on GCC compiler warnings.  There should be only a few.
 
+    --enable-weak-symbols
+	If the --with-pthread option is set, check if the compiler supports
+	weak-symbols.  If it does, then name the thread-capable library without
+	the "t" (libncurses rather than libncursest), and provide for
+	dynamically loading the pthreads entrypoints at runtime.  This allows
+	one to reduce the number of library files for ncurses.
+
     --enable-wgetch-events
 	Compile with experimental wgetch-events code.  See ncurses/README.IZ
 
@@ -625,20 +632,32 @@ SUMMARY OF CONFIGURE OPTIONS:
 	to do this if the target compiler has unusual flags which confuse the
 	host compiler.
 
+	You can also set the environment variable $BUILD_CFLAGS rather than
+	use this option.
+
     --with-build-cppflags=XXX
 	If cross-compiling, specify the host C preprocessor-flags.  You might
 	need to do this if the target compiler has unusual flags which confuse
 	the host compiler.
 
+	You can also set the environment variable $BUILD_CPPFLAGS rather than
+	use this option.
+
     --with-build-ldflags=XXX
 	If cross-compiling, specify the host linker-flags.  You might need to
 	do this if the target linker has unusual flags which confuse the host
 	compiler.
 
+	You can also set the environment variable $BUILD_LDFLAGS rather than
+	use this option.
+
     --with-build-libs=XXX
 	If cross-compiling, the host libraries.  You might need to do this if
 	the target environment requires unusual libraries.
 
+	You can also set the environment variable $BUILD_LIBS rather than
+	use this option.
+
     --with-caps=XXX
 	Specify an alternate terminfo capabilities file, which makes the
 	configure script look for "include/Caps.XXX".  A few systems, e.g.,
@@ -795,6 +814,14 @@ SUMMARY OF CONFIGURE OPTIONS:
 	may be unsigned.  Use this option if you need to preserve compatibility
 	with 64-bit executables.
 
+    --with-normal
+	Generate normal (i.e., static) libraries (default).
+
+	Note:  on Linux, the configure script will attempt to use the GPM
+	library via the dlsym() function call.  Use --without-dlsym to disable
+	this feature, or --without-gpm, depending on whether you wish to use
+	GPM.
+
     --with-ospeed=TYPE
 	Override type of ospeed variable, which is part of the termcap
 	compatibility interface.  In termcap, this is a 'short', which works
@@ -808,14 +835,6 @@ SUMMARY OF CONFIGURE OPTIONS:
 	those using termcap, do not use the higher speeds.  Your application
 	(or system, in general) may or may not.
 
-    --with-normal
-	Generate normal (i.e., static) libraries (default).
-
-	Note:  on Linux, the configure script will attempt to use the GPM
-	library via the dlsym() function call.  Use --without-dlsym to disable
-	this feature, or --without-gpm, depending on whether you wish to use
-	GPM.
-
     --with-profile
 	Generate profile-libraries These are named by adding "_p" to the root,
 	e.g., libncurses_p.a
@@ -898,6 +917,12 @@ SUMMARY OF CONFIGURE OPTIONS:
 	library.  As in termlib, there is no ABI difference between the
 	"wide" libticw.so and libtic.so
 
+	NOTE: Overriding the name of the tic library may be useful if you are
+	also using the --with-termlib option to rename libtinfo.  If you are
+	not doing that, renaming the tic library can result in conflicting
+	library dependencies for tic and other programs built with the tic
+	library.
+
     --with-trace
 	Configure the trace() function as part of the all models of the ncurses
 	library.  Normally it is part of the debug (libncurses_g) library only.