diff options
Diffstat (limited to 'nx-X11/programs/xterm/INSTALL')
| -rw-r--r-- | nx-X11/programs/xterm/INSTALL | 487 |
1 files changed, 0 insertions, 487 deletions
diff --git a/nx-X11/programs/xterm/INSTALL b/nx-X11/programs/xterm/INSTALL deleted file mode 100644 index 844ad8362..000000000 --- a/nx-X11/programs/xterm/INSTALL +++ /dev/null @@ -1,487 +0,0 @@ --- $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. |