Imported nx-X11-3.1.0-1.tar.gznx-X11/3.1.0-1

Summary: Imported nx-X11-3.1.0-1.tar.gz
Keywords:

Imported nx-X11-3.1.0-1.tar.gz
into Git repository

1 files changed, 487 insertions, 0 deletions

diff --git a/nx-X11/programs/xterm/INSTALL b/nx-X11/programs/xterm/INSTALL
new file mode 100644
index 000000000..844ad8362
--- /dev/null
+++ b/nx-X11/programs/xterm/INSTALL
@@ -0,0 +1,487 @@
+-- $XTermId: INSTALL,v 1.94 2005/11/03 13:17:26 tom Exp $
+-- $XFree86: xc/programs/xterm/INSTALL,v 3.40 2005/11/03 13:17:26 dickey Exp $
+-- Thomas E. Dickey
+
+Xterm is normally built as part of the X Window System source tree, using
+imake to generate a Makefile from Imakefile.  You can also use the
+configure script to generate a Makefile from Makefile.in:
+
+	+ If you have imake (or xmkmf), then you can use those directly,
+	  or use the configure script, which normally uses those tools
+	  to obtain the special definitions needed to build xterm.
+
+	  Ultimately, imake will not be necessary, since it is possible
+	  to add configure tests that derive the information that imake
+	  would supply.
+
+	+ You need the Athena widgets (or a clone, such as Xaw3d or
+	  neXtaw), to provide the popup menus.
+
+Even if you have imake, the configure script is still convenient because
+it allows you to build different configurations more easily than with
+imake, simply by specifying options to the configure script.
+
+Options:
+-------
+
+Autoconf configure scripts recognize two types of application-defined
+options, enable/disable and with/without.  The latter, by convention, are
+used for denoting inclusion of external packages, while the former denote
+enabling/disabling of internal features.  The configure --help option lists
+the available options.  This script uses "enable" and "disable" to indicate
+the sense of the default behavior.
+
+The options (in alphabetic order):
+
+  --disable-16-color      disable 16-color support
+
+	Do not compile-in code to recognize aixterm-style control sequences
+	that support color values 8-15.
+
+	Most color applications know only about 8 ANSI colors, but some
+	(e.g., ones built with ncurses) do.
+
+  --disable-active-icon   disable X11R6.3 active-icon feature
+
+	Do not compile-in code to support the active-icon feature.  This is
+	not configured on systems (e.g., X11R5) which lack the library
+	support needed.
+
+	Xterms with an active icon continue to respond to input and update
+	their display when iconified.  Not all window managers support
+	active icons.  Those that do include fvwm, olvwm and mwm.
+
+  --disable-ansi-color    disable ANSI color
+
+  	Do not compile-in code for ANSI colors.
+
+  --disable-blink-cursor  disable support for blinking cursor
+
+	Do not compile-in code that implements a blinking cursor.  The blinking
+	cursor is enabled either by resource setting or by popup menu entry.
+
+  --disable-bold-color    disable PC-style mapping of bold colors
+
+	Do not compile-in code that maps colors 8-15 to bold versions of
+	colors 0-7.
+
+	Some applications have hardcoded logic that assumes this.  It does
+	not interfere with the 16-color support.
+
+  --disable-boxchars      disable fallback-support for box chars
+
+  	Do not compile-in code to generate approximations for box/graphic
+	characters.
+
+	Most fonts do not contain the vt100-style graphic characters in
+	positions 0-31.  Many applications use the line-drawing characters,
+	e.g., to make boxes.  When xterm loads a font, it checks if those
+	characters are present, and draws its own if they are missing.
+
+  --disable-c1-print      disallow -k8 option for printable 128-159],
+
+	Use this option to suppress support for nonstandard use of codes
+	128-159, which normally are considered control characters.  Some users
+	have fonts which use those positions.  The default value for the
+	allowC1Printable resource is false, so this feature does not impact
+	normal users.
+
+  --disable-color-class   disable color class resources
+
+	Use this option to change most of the color resources to use Foreground
+	as the color class.  This is the older (before patch #157) behavior
+	which has the drawback that setting the Foreground resource on most
+	platforms prevents use of color since the class is evaluated before
+	the instance.
+
+  --disable-color-mode    disable default colorMode resource
+
+  	Do not compile-in code that sets the default value of the colorMode
+	resource to ``true''.
+
+  --disable-doublechars   disable support for double-size chars
+
+  	Do not compile-in code that supports font-manipulation needed to
+	implement vt100-style double-sized characters.
+
+  --disable-echo          test: display "compiling" commands
+
+  	Modify the generated Makefile so that most compiler options are
+	not shown.  This makes it simpler to read a build log and see the
+	actual warning messages.
+
+  --disable-freetype      disable freetype library-support
+
+ 	Do not use freetype libraries if they are found.  Normally they will
+	be used automatically.
+
+  --disable-full-tgetent  disable check for termcap library
+
+  	Do not look for the tgetent() function specifically in the termcap
+	library, accept the first library (from termlib, ncurses and curses)
+	which contains this function rather than continuing to search for
+	a termcap implementation rather than terminfo.  The former would
+	supply the complete $TERMCAP data needed for some legacy programs.
+
+  --disable-highlighting  disable support for color highlighting
+
+  	Do not compile-in code that allows the selected region to be a
+	different color than the reverse of foreground/background colors.
+
+	See the discussion of highlightColor in the manual.
+
+  --disable-i18n          disable internationalization
+
+  	Do not compile-in code to handle multi-byte characters.  This is
+	related to, but not identical with the input method logic.
+
+  --disable-imake         disable use of imake for definitions
+
+  	Do not attempt to use imake to determine compiler options.
+
+	The main.c file has many ifdef's which rely on obscure combinations
+	known only to imake.  The configure script implements only a
+	portion of the tests needed to supplant imake.
+
+  --disable-initial-erase disable setup for stty erase
+
+	Do not compile-in code which aligns the stty erase and the backarrow
+	key.  When compiled-in, xterm will optionally use the pty's sense
+	of stty erase and apply that to the backarrow mode (sending 8 or 127),
+	or go the other way, setting stty erase to match xterm's configuration.
+
+  --disable-input-method  disable input-method
+
+	Do not compile-in code for "input method".  This is an X11R6
+	feature which deals with translation of composite characters.
+
+	Some users report problems with their configuration, e.g., messages
+	stating that there is no input method defined for the given preedit
+	type.  If you do not need input method (and are troubled by the
+	warning messages), it is safe to disable this option.
+
+  --disable-maximize      disable actions for iconify/deiconify/maximize/restore
+
+	Do not compile-in code that implements runtime 'actions' for
+	iconifying, maximizing, etc.
+
+	Most users will find that the window manager is more suitable for
+	this sort of manipulation than putting the capabilities into xterm.
+
+  --disable-num-lock      disable NumLock keypad support
+
+	Do not compile-in code that looks for the actual NumLock key to
+	support vt100/vt220 keypad translation.
+
+	This is used in xterm to simplify logic, and to workaround some
+	quirks of the keyboard tables.  Use the ``numLock'' resource to
+	disable this feature if you must customize xterm in some other way.
+
+	(The same ifdef controls the metaSendsEscape support).
+
+  --disable-pty-handshake disable support for pty handshakes
+
+	This feature is used to ensure that the child process's terminal modes
+	match the parent's.  In particular, it addresses a problem where the
+	terminal size is not defined in the stty settings.
+
+  --disable-rightbar      disable right-scrollbar support
+
+  	Do not compile-in code that supports a scrollbar on the right.
+
+	Left/right scrollbars are a matter of taste.  Some older libraries
+	(e.g., X11R5) do not perform the geometry computation correctly,
+	leaving the right scrollbar incorrectly positioned after changing
+	the font size.
+
+  --disable-samename      disable check for redundant name-change
+
+	Do not compile-in code that suppresses redundant updates to the
+	titlebar when the text has not changed.
+
+  --disable-session-mgt   enable support for session management
+
+	Do not compile-in code which adds simple session management hooks which
+	are used when closing an xterm.  Normally the code is compiled-in,
+	except for systems which do not support it.
+
+  --disable-setuid        disable setuid/setgid
+
+	Do not install xterm using setuid or setgid permissions.  Drop setuid
+	and setgid permissions on startup.  This is done if you have linked
+	xterm with the utempter library, but may also be useful for systems
+	where the pseudoterminal and utmp interfaces are wrapped so that xterm
+	does not require these permissions.
+
+  --disable-tek4014       disable tek4014 emulation
+
+  	Do not compile-in code to support Tektronix 4014 emulation.
+
+	This reduces the executable size by 17% (checked 1999/3/13).
+
+	Some people use the Tektronix emulation (which has been in xterm
+	for many years) as an example of code bloat, though this is not an
+	accurate impression.
+
+  --disable-vt52          disable VT52 emulation
+
+  	Do not compile-in code to support vt52 emulation.
+
+	A genuine vt100 emulates a vt52.
+
+  --disable-ziconbeep     disable -ziconbeep option
+
+	Do not compile-in code that modifies the icon's title and sounds a
+	beep when they receive output.
+
+  --enable-256-color      enable 256-color support
+
+  	Compile-in code that interprets SGR 38 and 48 for 256-colors.
+
+  --enable-88-color       enable 88-color support
+
+	Compile-in code that interprets SGR 38 and 48 for 88-colors.
+
+  --enable-broken-osc     allow broken Linux OSC-strings],
+
+	Compile-in code to accommodate scripts that write Linux's malformed
+	palette control strings without checking.  The result makes xterm
+	appear to freeze.  This workaround makes xterm ignore the strings,
+	and is compiled-in by default for Linux.
+
+  --enable-broken-st      allow broken string-terminators],
+
+	Compile-in code that works around a bug in some ISDN routers (and
+	possibly other applications written by the same people):  they send an
+	unterminated control string in their banner text, making xterm freeze.
+	The workaround tells xterm to stop processing the control string when
+	it receives one of the whitespace control characters such as newline.
+	That was the behavior before patch #171.
+
+  --enable-dabbrev        enable dynamic-abbreviation support
+
+	Compile-in support for "dabbrev-expand()" action and related key
+	translation.
+
+  --enable-dec-locator    enable DECterm Locator support
+	Add support for DEC Locator control sequences for xterm:
+
+		DECEFR - Enable Filter Rectangle
+	        DECELR - Enable Locator Reports
+		DECSLE - Select Locator Events
+		DECRQLP - Request Locator Position
+
+	This allows the xterm mouse to be used with applications that use the
+	DEC Locator sequences, such as VAX Tpu, or SMG$ based applications.
+
+  --enable-hp-fkeys       enable support for HP-style function keys
+
+  	Compile-in code to support HP-style function keys.
+
+  --enable-load-vt-fonts  enable load-vt-fonts() action
+
+  	Compile-in code that allows user to define load different VT-font
+	definitions at runtime.
+
+  --enable-logfile-exec   enable exec'd logfile filter
+
+  	Compile-in code that allows logging piped via an external filter.
+
+  --enable-logging        enable logging
+
+  	Compile-in code that allows logging.
+
+	Logging was disabled in X11R5 xterm because of security problems.
+	They were addressed in X11R6, but the feature was not reinstated.
+
+  --enable-luit           enable support for luit filter (Unicode translation)
+
+	Luit is a filter that can be run between an arbitrary application and a
+	UTF-8 terminal emulator.  It will convert application output from the
+	locale's encoding into UTF-8, and convert terminal input from UTF-8
+	into the locale's encoding.
+
+	This sets "--enable-wide-chars" as a side-effect.
+
+  --enable-mini-luit      enable support for poor man's luit filter (Latin-9)
+
+	Provide built-in support for Latin-9, relying on having specified
+	Unicode (ISO10646) fonts and setting the locale resource to "checkfont".
+
+	This sets "--enable-luit" as a side-effect.
+
+  --enable-narrowproto    enable narrow prototypes for X libraries
+
+	Originally xterm was built using imake rather than a configure script. 
+	One feature of imake that is not possible to guess within the
+	configure script is the wide-prototype compile-time definition
+	NARROWPROTO.  When this is not set properly, the Athena widget
+	scrollbars do not work properly.  xterm's configure script has a
+	fallback case which allows disabling imake.  However, this is moot
+	with the Xorg "modular" build, whose compiler options are unrelated to
+	imake or older versions of any libraries that it may distribute.  In
+	this case, the configure script needs some help.  Use this option to
+	enable or disable NARROW proto (and disable imake with the
+	--disable-imake option) to match the whims of Xorg hackers.
+
+	For instance
+
+		configure --disable-imake --disable-narrowproto
+
+  --enable-paste64        enable support for bracketed paste mode
+
+	Compile-in code to support experimental bracketed paste mode, i.e.,
+	provide functions for setting/getting the selection data.
+
+	(see ctlseqs.ms description of OSC 52).
+
+  --enable-readline-mouse enable support for mouse in readline applications
+
+	Compile-in code to support experimental bracketed paste mode, i.e.,
+	provide functions for setting/getting the selection data.  Essentially
+	this puts xterm into a mode that sends special function-key strings to
+	bracket the data.
+
+	(See --enable-paste64, which fits xterm's protocol better).
+
+  --enable-sco-fkeys      enable support for SCO-style function keys
+
+  	Compile-in code to support SCO-style function keys.
+
+  --enable-tcap-query     enable termcap query/report
+
+	Compile-in code to support experimental DCS '+' control sequence, which
+	allows an application to ask xterm what control sequences it would
+	transmit for specified function keys, given the termcap or terminfo
+	names.
+
+  --enable-toolbar        enable pulldown menus on toolbar
+
+  	Compile-in code that builds a toolbar with pulldown menus.  The
+	normal popup menus are still available.
+
+	This is an experimental option.  As of patch #206, it is known to
+	work well with fvwm, but not as well with some other window managers,
+	e.g., KDE's Kwin and IceWM.
+
+	In addition to isolated layout problems, it is reported that some
+	flavors of the Athena widget library perform badly with ISO-10646
+	fonts.  You can work around those by setting the menu fonts to
+	an ISO-8859 variant in your X resources.
+
+  --enable-trace          test: set to enable debugging traces
+
+  	Compile-in code to trace xterm's internal states.
+
+	This is a debugging feature.  It causes xterm to produce two files
+	(Trace-parent.out and Trace-child.out).
+
+  --enable-warnings       test: turn on GCC compiler warnings
+
+	Modify the generate Makefile to turn on gcc compiler warnings.
+
+	I use this option regularly, and correct all but a few (difficult)
+	problems.
+
+  --enable-wide-chars     enable wide-character support
+
+  	Compile-in code that supports 16-bit characters.  Includes support
+	for UTF-8.
+
+  --enable-xmc-glitch     test: enable xmc magic-cookie emulation
+
+  	Compile-in code that simulates the terminfo "magic cookie" glitch.
+
+	This is for testing ncurses.
+
+  --with-Xaw3d            link with Xaw 3d library
+
+  	Look for, compile and link with the Xaw 3d widget library.
+
+  --with-XawPlus          link with Athena-Plus library
+
+  	Look for, compile and link with the Xaw Plus widget library.
+
+  --with-freetype-cflags  -D/-I options for compiling with FreeType library
+
+	Override options provided by xft-config or freetype-config.
+
+  --with-freetype-libs    -L/-l options for linking with FreeType library
+
+	Override options provided by xft-config or freetype-config.
+
+  --with-neXtaw           link with neXT Athena library
+
+  	Look for, compile and link with the neXT Athena widget library.
+
+  --with-own-terminfo=P   set default $TERMINFO (default: from environment)
+
+  	Modify the generated Makefile to set the target for the 'install-ti'
+	rule to point to the given directory.
+
+	If you have the $TERMINFO variable defined in your environment, the
+	configure script will use that value.  If no option and no variable
+	are are given, the configure script uses /usr/lib/terminfo, if it
+	exists.
+
+	You do not have to run "make install-ti", if there is already a
+	workable terminfo description.  Be advised, however, that the
+	common variety of "xterm-color" is not suited for xterm, but is
+	directed to other variations (such as nxterm) which do not
+	support the back-color erase capability.
+
+  --with-reference=XXX    program to use as permissions-reference
+
+	To install xterm with setuid permissions, the scripts usually compare
+	it with a previous install.  That works well for individual
+	maintainers, but can be a problem for packagers who may be
+	cross-compiling, etc.  This option lets the package builder specify
+	the file used for permissions reference.
+
+  --with-setuid=XXX       use the given setuid user
+
+	Install xterm setuid'd to the given user.  If no parameter value
+	is given, assume it is root.
+
+	See also --with-utmp-setgid and --with-utempter, which manipulate
+	the setgid group.
+
+  --with-terminal-id[=V]  set default decTerminalID (default: vt100)
+
+  	Set the default emulation level.
+
+	DEC terminals vt52/vt100/vt220/etc form a series where succeeding
+	models emulate features of the older terminals.  While most
+	features of these terminals are recognized by xterm at all levels,
+	a few behave differently according to the emulation level.
+
+	You can always override this with the command-line option "-ti".
+
+  --with-terminal-type=T  set default $TERM (default: xterm)
+
+	Set the default value for $TERM.  Xterm supports legacy termcap
+	applications by constructing a modified version of the $TERMCAP
+	variable at initialization, which supplies the resulting screen
+	size.  It also sets $TERM, if not already set, for use by programs
+	running within xterm.
+
+	The default value "xterm", can be overridden to avoid conflict
+	with older versions of xterm, e.g., those that do not implement
+	vt220 emulation.
+
+	You can always override this with the command-line option "-tn".
+
+  --with-utempter         use utempter library for access to utmp
+
+	The utempter library is a set-uid wrapper for the utmp facility.
+	On systems with Unix98 pty's, xterm can use this library when
+	available so it need not be installed set-uid.
+
+  --with-utmp-setgid      use setgid for access to utmp
+
+	The option value specifies a group to use when installing.
+	xterm will be installed with setgid privilege to this group.
+	At runtime, xterm will drop the setuid privilege immediately
+	after opening the pseudo-terminal, and will have only the
+	group privilege needed to access the utmp file.  This relies
+	on having POSIX setuid behavior.