"Fossies" - the Fresh Open Source Software Archive 
Member "xterm-379/INSTALL" (12 Feb 2023, 33690 Bytes) of package /linux/misc/xterm-379.tgz:
As a special service "Fossies" has tried to format the requested text file into HTML format (style:
standard) with prefixed line numbers.
Alternatively you can here
view or
download the uninterpreted source code file.
See also the latest
Fossies "Diffs" side-by-side code changes report for "INSTALL":
377_vs_379.
1 -- $XTermId: INSTALL,v 1.192 2023/02/12 19:17:48 tom Exp $
2 -------------------------------------------------------------------------------
3 -- Copyright 1997-2022,2023 by Thomas E. Dickey
4 --
5 -- All Rights Reserved
6 --
7 -- Permission is hereby granted, free of charge, to any person obtaining a
8 -- copy of this software and associated documentation files (the
9 -- "Software"), to deal in the Software without restriction, including
10 -- without limitation the rights to use, copy, modify, merge, publish,
11 -- distribute, sublicense, and/or sell copies of the Software, and to
12 -- permit persons to whom the Software is furnished to do so, subject to
13 -- the following conditions:
14 --
15 -- The above copyright notice and this permission notice shall be included
16 -- in all copies or substantial portions of the Software.
17 --
18 -- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 -- OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 -- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21 -- IN NO EVENT SHALL THE ABOVE LISTED COPYRIGHT HOLDER(S) BE LIABLE FOR ANY
22 -- CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 -- TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 -- SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 --
26 -- Except as contained in this notice, the name(s) of the above copyright
27 -- holders shall not be used in advertising or otherwise to promote the
28 -- sale, use or other dealings in this Software without prior written
29 -- authorization.
30 -------------------------------------------------------------------------------
31
32 Xterm was originally built as part of the X Window System source tree, using
33 imake to generate a Makefile from Imakefile.
34
35 An example Imakefile is provided for legacy use (with xmkmf).
36
37 The preferred method uses the configure script to generate a Makefile from
38 Makefile.in
39
40 Options:
41 -------
42
43 Autoconf configure scripts recognize two types of application-defined
44 options, enable/disable and with/without. The latter, by convention, are
45 used for denoting inclusion of external packages, while the former denote
46 enabling/disabling of internal features. The configure --help option lists
47 the available options. This script uses "enable" and "disable" to indicate
48 the sense of the default behavior.
49
50 The options (in alphabetic order):
51
52 --disable-256-color disable 256-color support
53
54 Do not compile-in code that interprets SGR 38 and 48 for 256-colors.
55 If this feature is disabled, the 88-color feature will be used.
56
57 --disable-88-color disable 88-color support
58
59 Do not compile-in code that interprets SGR 38 and 48 for 88-colors.
60 The 256-color option overrides this.
61
62 --disable-16-color disable 16-color support
63
64 Do not compile-in code to recognize aixterm-style control sequences
65 that support color values 8-15.
66
67 Most color applications know only about 8 ANSI colors, but some
68 (e.g., ones built with ncurses) do.
69
70 --disable-active-icon disable X11R6.3 active-icon feature
71
72 Do not compile-in code to support the active-icon feature. This is
73 not configured on systems (e.g., X11R5) which lack the library
74 support needed.
75
76 Xterms with an active icon continue to respond to input and update
77 their display when iconified. Not all window managers support
78 active icons. Those that do include fvwm, olvwm and mwm.
79
80 --disable-ansi-color disable ANSI color
81
82 Do not compile-in code for ANSI colors.
83
84 --disable-blink-cursor disable support for blinking cursor
85
86 Do not compile-in code that implements a blinking cursor. The blinking
87 cursor is enabled either by resource setting or by popup menu entry.
88
89 --disable-bold-color disable PC-style mapping of bold colors
90
91 Do not compile-in code that maps colors 8-15 to bold versions of
92 colors 0-7.
93
94 Some applications have hardcoded logic that assumes this. It does
95 not interfere with the 16-color support.
96
97 --disable-boxchars disable fallback-support for box chars
98
99 Do not compile-in code to generate approximations for box/graphic
100 characters.
101
102 Most fonts do not contain the vt100-style graphic characters in
103 positions 0-31. Many applications use the line-drawing characters,
104 e.g., to make boxes. When xterm loads a font, it checks if those
105 characters are present, and draws its own if they are missing.
106
107 --disable-broken-st disallow broken string-terminators,
108
109 Do not compile-in code that works around a bug in some ISDN routers
110 (and possibly other applications written by the same people): they
111 send an unterminated control string in their banner text, making xterm
112 freeze.
113
114 The workaround tells xterm to stop processing the control string when
115 it receives one of the whitespace control characters such as newline.
116 That was the behavior before patch #171.
117
118 See also --enable-broken-osc
119
120 --disable-c1-print disallow -k8 option for printable 128-159,
121
122 Use this option to suppress support for nonstandard use of codes
123 128-159, which normally are considered control characters. Some users
124 have fonts which use those positions. The default value for the
125 allowC1Printable resource is false, so this feature does not impact
126 normal users.
127
128 --disable-color-class disable color class resources
129
130 Use this option to change most of the color resources to use Foreground
131 as the color class. This is the older (before patch #157) behavior
132 which has the drawback that setting the Foreground resource on most
133 platforms prevents use of color since the class is evaluated before
134 the instance.
135
136 --disable-color-mode disable default colorMode resource
137
138 Do not compile-in code that sets the default value of the colorMode
139 resource to ``true''.
140
141 --disable-desktop disable install of xterm desktop files
142
143 Do not install the xterm desktop files, used in menus.
144 These use the icons installed in the --with-icondir option.
145 Use the environment variable $DESKTOP_FLAGS to supply options
146 required by desktop-file-install.
147
148 Note: If desktop-utils is not found they will not be installed anyway.
149
150 --disable-direct-color disable direct color support
151
152 Do not compile-in code that interprets SGR 38 and 48 for direct colors.
153 This feature extends the 256-color feature.
154
155 --disable-doublechars disable support for double-size chars
156
157 Do not compile-in code that supports font-manipulation needed to
158 implement vt100-style double-sized characters.
159
160 --disable-echo test: display "compiling" commands
161
162 Modify the generated Makefile so that most compiler options are
163 not shown. This makes it simpler to read a build log and see the
164 actual warning messages.
165
166 --disable-exec-selection disable "exec-formatted" and "exec-selection" actions
167
168 Do not compile-in code for the "exec-formatted" and "exec-selection"
169 actions, which allow the user to run programs to process the results
170 of selecting text.
171
172 --disable-fifo-lines enable FIFO-storage for saved-lines
173
174 (this option is deprecrated)
175
176 --disable-freetype disable freetype library-support
177
178 Do not use freetype libraries if they are found. Normally they will
179 be used automatically.
180
181 --disable-full-tgetent disable check for termcap library
182
183 Do not look for the tgetent() function specifically in the termcap
184 library, accept the first library (from termlib, ncurses and curses)
185 which contains this function rather than continuing to search for
186 a termcap implementation rather than terminfo. The former would
187 supply the complete $TERMCAP data needed for some legacy programs.
188
189 --disable-highlighting disable support for color highlighting
190
191 Do not compile-in code that allows the selected region to be a
192 different color than the reverse of foreground/background colors.
193
194 See the discussion of highlightColor in the manual.
195
196 --disable-i18n disable internationalization
197
198 Do not compile-in code to handle multi-byte characters. This is
199 related to, but not identical with the input method logic.
200
201 --disable-imake disable use of imake for definitions
202
203 Do not attempt to use imake to determine compiler options.
204
205 The main.c file has many ifdef's which rely on obscure combinations
206 known only to imake. The configure script implements only a
207 portion of the tests needed to supplant imake.
208
209 --disable-initial-erase disable setup for stty erase
210
211 Do not compile-in code which aligns the stty erase and the backarrow
212 key. When compiled-in, xterm will optionally use the pty's sense
213 of stty erase and apply that to the backarrow mode (sending 8 or 127),
214 or go the other way, setting stty erase to match xterm's configuration.
215
216 --disable-input-method disable input-method
217
218 Do not compile-in code for "input method". This is an X11R6
219 feature which deals with translation of composite characters.
220
221 Some users report problems with their configuration, e.g., messages
222 stating that there is no input method defined for the given preedit
223 type. If you do not need input method (and are troubled by the
224 warning messages), it is safe to disable this option.
225
226 --disable-leaks test: free permanent memory, analyze leaks
227
228 Compile-in code which frees memory which might confuse a leak-testing
229 tool. Normally these chunks of memory are retained as long as xterm
230 is running.
231
232 --disable-luit disable support for luit filter (Unicode translation)
233
234 Luit is a filter that can be run between an arbitrary application and a
235 UTF-8 terminal emulator. It will convert application output from the
236 locale's encoding into UTF-8, and convert terminal input from UTF-8
237 into the locale's encoding.
238
239 This is normally enabled, relying upon "--enable-wide-chars".
240
241 --disable-maximize disable actions for iconify/deiconify/maximize/restore
242
243 Do not compile-in code that implements runtime 'actions' for
244 iconifying, maximizing, etc.
245
246 Most users will find that the window manager is more suitable for
247 this sort of manipulation than putting the capabilities into xterm.
248
249 --disable-num-lock disable NumLock keypad support
250
251 Do not compile-in code that looks for the actual NumLock key to
252 support vt100/vt220 keypad translation.
253
254 This is used in xterm to simplify logic, and to workaround some
255 quirks of the keyboard tables. Use the ``numLock'' resource to
256 disable this feature if you must customize xterm in some other way.
257
258 (The same ifdef controls the metaSendsEscape support).
259
260 --disable-openpty disable openpty, prefer other interfaces
261
262 Do not check for, or use openpty(). Instead, use other interfaces such
263 as posix_openpt(). Modern (sic) BSD systems should have a workable
264 openpty() interface. Older systems may not.
265
266 --disable-paste64 disable support for bracketed paste mode
267
268 Do not compile-in code to support bracketed paste mode, along with
269 functions for setting/getting the selection data, termed "paste64".
270
271 (see ctlseqs.ms description of OSC 52, and DECSET 2004).
272
273 --disable-print-graphics disable screen dump to sixel support
274
275 Do not compile-in code to support screen-dumps for ReGIS graphics.
276
277 --disable-pty-handshake disable support for pty handshakes
278
279 This feature is used to ensure that the child process's terminal modes
280 match the parent's. In particular, it addresses a problem where the
281 terminal size is not defined in the stty settings.
282
283 --disable-rectangles disable VT420 rectangle support
284
285 Do not compile-in code to support VT420 rectangle control-sequences.
286
287 --disable-regex disable regular-expression selections
288
289 Do not compile-in code to support the "regex" option for multiple
290 mouse clicks.
291
292 --disable-rightbar disable right-scrollbar support
293
294 Do not compile-in code that supports a scrollbar on the right.
295
296 Left/right scrollbars are a matter of taste. Some older libraries
297 (e.g., X11R5) do not perform the geometry computation correctly,
298 leaving the right scrollbar incorrectly positioned after changing
299 the font size.
300
301 --disable-readline-mouse enable support for mouse in readline applications
302
303 Do not compile-in code to support readline with mouse.
304
305 (The "paste64" feature, which fits xterm's protocol better, is
306 configured by default).
307
308 --disable-rpath-hack don't add rpath options for additional libraries
309
310 By default, the configure script looks for libraries in unusual places
311 and adds an rpath linker option to help.
312
313 --disable-samename disable check for redundant name-change
314
315 Do not compile-in code that suppresses redundant updates to the
316 titlebar when the text has not changed.
317
318 --disable-screen-dumps disable XHTML and SVG screen dumps
319
320 Do not compile-in code that provides XHTML and SVG screen dumps.
321
322 --disable-selection-ops disable selection operations
323
324 Do not compile-in code to support the actions which allow users
325 to bind keys that use the selection or extract data from the screen.
326
327 --disable-session-mgt enable support for session management
328
329 Do not compile-in code which adds simple session management hooks
330 which are used when closing an xterm. Normally the code is
331 compiled-in, except for systems which do not support it.
332
333 --disable-setgid disable setgid
334
335 Do not install xterm using setuid/setgid permissions. Drop setgid
336 permissions on startup.
337
338 --disable-setuid disable setuid
339
340 Do not install xterm using setuid/setgid permissions. Drop setuid
341 permissions on startup.
342
343 --disable-sixel-graphics disable support for sixel-graphics
344
345 Do not compile-in code to support sixel-graphics
346
347 --disable-sun-fkeys
348
349 Do not compile-in code to support Sun-style function keys.
350
351 --disable-tcap-fkeys disable termcap function-keys
352
353 Do not compile-in code to support feature which allows xterm to use the
354 function-key definitions from the termcap/terminfo entry which it used
355 to set the $TERM variable on startup.
356
357 --disable-tcap-query disable termcap query/report
358
359 Do not compile-in code to support DCS '+' control sequence, which
360 allows an application to ask xterm what control sequences it would
361 transmit for specified function keys, given the termcap or terminfo
362 names.
363
364 --disable-tek4014 disable tek4014 emulation
365
366 Do not compile-in code to support Tektronix 4014 emulation.
367
368 This reduces the executable size by 17% (checked 1999/3/13).
369
370 Some people use the Tektronix emulation (which has been in xterm
371 for many years) as an example of code bloat, though this is not an
372 accurate impression.
373
374 --disable-vt52 disable VT52 emulation
375
376 Do not compile-in code to support vt52 emulation.
377
378 A genuine vt100 emulates a vt52.
379
380 --disable-wide-attrs disable wide-attribute support
381
382 Xterm's base attributes include all of those used in DEC terminals.
383 ISO 6429 defines a few more which historically have found little use.
384 Some people find these amusing.
385
386 This is normally enabled. The direct-colors feature relies upon it.
387
388 --disable-wide-chars disable wide-character support
389
390 The wide-character code supports Unicode and UTF-8.
391
392 This is normally enabled.
393
394 --disable-xcursor disable cursorTheme resource
395
396 Do not compile-in code that sets the XCURSOR_THEME environment variable
397 to enable/disable cursor themes.
398
399 --disable-ziconbeep disable -ziconbeep option
400
401 Do not compile-in code that modifies the icon's title and sounds a
402 beep when they receive output.
403
404 --enable-16bit-chars enable 16-bit characters support
405
406 Enable wide-character support, but store only 16-bits for each wide
407 character. Unicode values can be larger than 16-bits, up to 21-bits.
408 This uses less memory, but is less complete. However, most languages
409 are covered by the 16-bit encoding.
410
411 --enable-alt-sends-esc set default altSendsEscape resource (default: no)
412
413 This sets the default resource value, which is shown in the manpage.
414
415 --enable-backarrow-key set default backarrowKey resource (default: true)
416
417 This sets the default resource value, which is shown in the manpage.
418
419 --enable-backarrow-is-erase set default backarrowKeyIsErase resource (default: false)
420
421 This sets the default resource value, which is shown in the manpage.
422
423 --enable-broken-osc allow broken Linux OSC-strings
424
425 Compile-in code to accommodate scripts that write Linux's malformed
426 palette control strings without checking. The result makes xterm
427 appear to freeze. This workaround makes xterm ignore the strings,
428 and is compiled-in by default for Linux.
429
430 --enable-builtin-xpms compile-in icon data
431
432 Compile-in X pixmap data for these icons:
433 filled-xterm
434 mini.xterm
435 xterm-color
436 xterm
437 at these sizes
438 16x16
439 32x32
440 48x48
441
442 --enable-dabbrev enable dynamic-abbreviation support
443
444 Compile-in support for "dabbrev-expand()" action and related key
445 translation.
446
447 --enable-dec-locator enable DECterm Locator support
448 Add support for DEC Locator control sequences for xterm:
449
450 DECEFR - Enable Filter Rectangle
451 DECELR - Enable Locator Reports
452 DECSLE - Select Locator Events
453 DECRQLP - Request Locator Position
454
455 This allows the xterm mouse to be used with applications that use the
456 DEC Locator sequences, such as VAX Tpu, or SMG$ based applications.
457
458 --enable-delete-is-del set default deleteIsDEL resource (default: maybe)
459
460 This sets the default resource value, which is shown in the manpage.
461
462 --enable-double-buffer enable double-buffering
463
464 Set the initial value of the "buffered" resource, which tells
465 xterm to use double-buffering for display to reduce flicker.
466
467 --enable-env-terminfo setenv $TERMINFO if --with-own-terminfo gives value
468
469 Use the custom terminfo directory specified in "--with-own-terminfo"
470 as the $TERMINFO variable for the shells spawned by xterm. Setting
471 this variable makes most curses (and termcap) applications look in
472 that directory for terminal descriptions.
473
474 --enable-exec-xterm enable "spawn-new-terminal" action
475
476 If your platform supports the process filesystem "cwd" link,
477 compile-in support for the "spawn-new-terminal" action, which
478 allows you to define a key translation that runs a new xterm
479 using the same working directory as the current process within
480 xterm.
481
482 --enable-hp-fkeys enable support for HP-style function keys
483
484 Compile-in code to support HP-style function keys.
485
486 --enable-load-vt-fonts enable load-vt-fonts() action
487
488 Compile-in code that allows user to define load different VT-font
489 definitions at runtime.
490
491 --enable-logfile-exec enable exec'd logfile filter
492
493 Compile-in code that allows logging piped via an external filter.
494
495 --enable-logging enable logging
496
497 Compile-in code that allows logging.
498
499 Logging was disabled in X11R5 xterm because of security problems.
500 They were addressed in X11R6, but the feature was not reinstated
501 because of concerns (long past) about xterm running as root-setuid.
502
503 --enable-meta-sends-esc set default metaSendsEscape resource (default: no)
504
505 This sets the default resource value, which is shown in the manpage.
506
507 --enable-mini-luit enable support for poor man's luit filter (Latin-9)
508
509 Provide built-in support for Latin-9, relying on having specified
510 Unicode (ISO10646) fonts and setting the locale resource to "checkfont".
511
512 This sets "--enable-luit" as a side-effect.
513
514 --enable-narrowproto enable narrow prototypes for X libraries
515
516 Originally xterm was built using imake rather than a configure script.
517 One feature of imake that is not possible to guess within the
518 configure script is the wide-prototype compile-time definition
519 NARROWPROTO. When this is not set properly, the Athena widget
520 scrollbars do not work properly. xterm's configure script has a
521 fallback case which allows disabling imake. However, this is moot
522 with the X.org "modular" build, whose compiler options are unrelated to
523 imake or older versions of any libraries that it may distribute. In
524 this case, the configure script needs some help. Use this option to
525 enable or disable NARROW proto (and disable imake with the
526 --disable-imake option) to match the whims of X.org hackers.
527
528 For instance
529
530 configure --disable-imake --disable-narrowproto
531
532 --enable-pty-erase set default ptyInitialErase resource (default: false)
533
534 This sets the default resource value, which is shown in the manpage.
535
536 --enable-regis-graphics enable support for ReGIS graphics
537
538 Compile-in code to support experimental ReGIS graphics
539
540 --enable-sco-fkeys enable support for SCO-style function keys
541
542 Compile-in code to support SCO-style function keys.
543
544 --enable-status-line enable support for status-line
545
546 Compile-in code to enable VT220-VT525 support for status-line.
547
548 --enable-stdnoreturn enable C11 _Noreturn feature for diagnostics
549
550 Use the C11 _Noreturn keyword if the compiler supports it, rather
551 than the gcc-specific __attribute__((noreturn)).
552
553 --enable-toolbar enable pulldown menus on toolbar
554
555 Compile-in code that builds a toolbar with pulldown menus. The
556 normal popup menus are still available.
557
558 This is an experimental option. As of patch #206, it is known to
559 work well with fvwm, but not as well with some other window managers,
560 e.g., KDE's Kwin and IceWM.
561
562 In addition to isolated layout problems, it is reported that some
563 flavors of the Athena widget library perform badly with ISO-10646
564 fonts. You can work around those by setting the menu fonts to
565 an ISO-8859 variant in your X resources.
566
567 --enable-trace test: set to enable debugging traces
568
569 Compile-in code to trace xterm's internal states.
570
571 This is a debugging feature. It causes xterm to produce two files
572 (Trace-parent.out and Trace-child.out).
573
574 --enable-warnings test: turn on GCC compiler warnings
575
576 Modify the generate Makefile to turn on gcc compiler warnings.
577
578 I use this option regularly, and correct all but a few (difficult)
579 problems.
580
581 --enable-xmc-glitch test: enable xmc magic-cookie emulation
582
583 Compile-in code that simulates the terminfo "magic cookie" glitch.
584
585 This is for testing ncurses.
586
587 --with-Xaw3d link with Xaw 3d library
588
589 Look for, compile and link with the Xaw 3d widget library.
590
591 --with-Xaw3dxft link with Xaw 3d xft library
592
593 Look for, compile and link with the Xaw 3d xft widget library.
594
595 --with-XawPlus link with Athena-Plus library
596
597 Look for, compile and link with the Xaw Plus widget library.
598
599 --with-app-class=XXX X resource class (default: XTerm)
600
601 Rename the X resource class, e.g., for packaging a development version
602 of xterm with different result names.
603
604 --with-app-defaults=DIR directory in which to install resource files (default: EPREFIX/lib/X11/app-defaults)
605
606 autoconf scripts assume that all of the files should be installed
607 under the same top-level directory. But X applications defaults
608 must be installed into a special directory, e.g.,
609
610 /usr/X11/lib/app-defaults
611
612 However, there is no standard for this pathname. The manual page
613 for X notes that the environment variable $XUSERFILESEARCHPATH can
614 specify a list of places where X searches for applications defaults.
615 Also, it may look in $XAPPLRESDIR, but that usually is not related
616 to where xterm might be installed. To keep it simple, the configure
617 script uses
618
619 EPREFIX/lib/X11/app-defaults
620
621 as the default (EPREFIX is --prefix). That makes it work normally
622 for most systems if --prefix is /usr. For other installs, e.g., to
623 /usr/local, you should use this option to customize the location to
624 match your system configuration.
625
626 Use --with-app-defaults=auto to ask the configure script to look in
627 a list of well-known locations for an existing directory.
628
629 Use --without-app-defaults or --with-app-defaults=no to disable the
630 feature.
631
632 --with-dmalloc test: use Gray Watson's dmalloc library
633
634 Check for and link with dmalloc.
635
636 --with-dbmalloc test: use Conor Cahill's dbmalloc library
637
638 Check for and link with dbmalloc.
639
640 --with-desktop-category=XXX one or more desktop categories or auto
641 This is a list of names. The configure script maps blanks and commas
642 to semicolons (";") which are used by the desktop utilities as a
643 separator.
644
645 The default value "auto" tells the configure script to look
646 at existing ".desktop" files for xterm and common terminal
647 emulators, to use those. If none are found, the script uses this
648 default:
649 System;TerminalEmulator;
650
651 --with-freetype-config configure script to use for FreeType
652
653 Use a specific option value to tell the configure script to try
654 just one of the variations:
655
656 "pkg*", e.g., pkg-config or pkgconfig uses whatever pkg-config
657 script was found.
658
659 otherwise, the parameter value is used as the name of the script
660 to try, using --cflags and --libs options.
661
662 Use --without-freetype-config to enable the --with-freetype-cflags
663 and --with-freetype-libs options.
664
665 The default value "auto" tells the configure script to try the
666 pkg-config script first, then freetype-config and finally xft-config.
667
668 --with-freetype-cflags -D/-I options for compiling with FreeType library
669
670 Override options provided by xft-config or freetype-config.
671
672 --with-freetype-libs -L/-l options for linking with FreeType library
673
674 Override options provided by xft-config or freetype-config.
675
676 --with-icon-name=NAME override icon name (default: xterm-color)
677
678 xterm comes with a choice of icons:
679
680 xterm-color: depicts a conventional terminal image, and is the default
681 icon used for icon-themes.
682
683 mini.xterm: a more iconic choice which is readily identifiable at
684 small sizes. This is used for window decoration, e.g., the
685 icon at the upper left corner in many window managers.
686
687 --with-icon-symlink=NAME create symbolic links to icon name (default: NONE)
688
689 This is a workaround for certain systems which translate icon names
690 containing "xterm", e.g., "xterm-color" into the single icon "xterm".
691 The option should also be harmless on a properly configured system.
692
693 If the option is used, its default value is "xterm". For each icon,
694 the makefile will strip the suffix (e.g., ".png"), as well as the part
695 of the filename which denotes the size (e.g., "_32x32" in an xpm file),
696 and constructs a link with that name to the icon.
697
698 If the option is unused, its default value is "NONE" (no link is made).
699
700 --with-icondir=DIR directory in which to install icon files (default: no)
701
702 The X libraries may automatically search these locations:
703
704 $HOME/.icons
705 $XDG_DATA_DIRS/icons
706 /usr/share/pixmaps
707
708 Alternatively, the last may be actually
709 /usr/X11R6/share/pixmaps
710
711 Use --with-icondir=auto to tell the configure script to search for
712 an existing directory from its list of well-known system locations.
713
714 See also
715 http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html
716 http://www.freedesktop.org/software/icon-theme/
717
718 By default, the option is disabled; it is useful only for the
719 --with-icon-theme option.
720
721 --with-icon-theme=XXX install icons into desktop theme (hicolor)
722
723 Install png and svg icons into the given desktop theme and customize
724 the .desktop files to use that theme. If no theme name is given,
725 the default is "hicolor". If this option is not given, the desktop
726 file will use the pixmap files.
727
728 --with-man2html[=XXX] use XXX rather than groff
729
730 Specify an alternative program to use for converting manpages and
731 control sequences document to html. The default value for the option
732 is "man2html". If the "man2html" script is not found, then "groff" is
733 used with groff's special options.
734
735 The "man2html" script reads formatted nroff output from its standard
736 input, and writes html to its standard output. Other input/output
737 conventions are not currently supported.
738
739 See
740 http://invisible-island.net/scripts
741 http://invisible-island.net/scripts/man2html.html
742
743 for an up-to-date version of "man2html".
744
745 --with-neXtaw link with neXT Athena library
746
747 Look for, compile and link with the neXT Athena widget library.
748
749 --with-own-terminfo=P set default $TERMINFO (default: from environment)
750
751 Modify the generated Makefile to set the target for the 'install-ti'
752 rule to point to the given directory.
753
754 If you have the $TERMINFO variable defined in your environment, the
755 configure script may use that value, if it matches an existing
756 directory. If no option and no variable are are given, the configure
757 script uses /usr/lib/terminfo, if it exists.
758
759 You do not have to run "make install-ti", if there is already a
760 workable terminfo description. Be advised, however, that the
761 common variety of "xterm-color" is not suited for xterm, but is
762 directed to other variations (such as nxterm) which do not
763 support the background-color erase capability.
764
765 --with-pixmapdir=DIR directory in which to install pixmaps (DATADIR/pixmaps)
766
767 Specify directory in which to install ".xpm" files.
768
769 --with-pcre use PCRE for regular-expressions
770
771 If regular expressions are not disabled (--disable-regex), use PCRE
772 rather than the POSIX regular expressions.
773
774 --with-pcre2 use PCRE2 for regular-expressions
775
776 If regular expressions are not disabled (--disable-regex), use PCRE2
777 rather than the POSIX regular expressions.
778
779 --with-pkg-config{=path} enable/disable use of pkg-config
780
781 The configure script looks for certain libraries which have well
782 established pkg-config scripts, and will use those settings if
783 available. Not all pkg-config scripts work; this option suppresses
784 the check and relies on normal library search paths.
785
786 --with-reference=XXX program to use as permissions-reference
787
788 To install xterm with setuid permissions, the scripts usually compare
789 it with a previous install. That works well for individual
790 maintainers, but can be a problem for packagers who may be
791 cross-compiling, etc. This option lets the package builder specify
792 the file used for permissions reference.
793
794 --with-setuid=XXX use the given setuid user
795
796 Install xterm setuid'd to the given user. If no parameter value
797 is given, assume it is root.
798
799 See also --with-utmp-setgid and --with-utempter, which manipulate
800 the setgid group.
801
802 --with-tty-group=XXX use XXX for the tty-group
803
804 If xterm is installed setuid'd to root, change the group of the tty
805 device to the given value on startup. Three cases are possible:
806
807 a) If this option is not given, the configure script will attempt to
808 find a suitable value (usually "tty"), and verify that it exists in
809 the group database.
810
811 b) If the option value is given, it will use the value even if it does
812 not exist in the group database (allowing packagers to work about
813 deficient environments).
814
815 c) If the option is disabled, e.g., --without-tty-group, the
816 permissions change will use the group-id of the process.
817
818 If xterm is not installed setuid'd to root, this option is not needed,
819 since it cannot change the tty device's ownership.
820
821 --with-valgrind test: use valgrind
822
823 Activate the --disable-leaks option, and ensure that "-g" is added to
824 CFLAGS.
825
826 --without-xinerama do not use Xinerama extension for multiple screens
827
828 Xinerama is an X server extension that allows multiple physical
829 screens to behave as a single screen. If you do not need the feature
830 (or do not want the extra library dependency), use this option to
831 suppress it.
832
833 --with-xpm=DIR use Xpm library for colored icon, may specify path
834
835 Use Xpm library to show colored icon in window decoration, e.g.,
836 title area.
837
838 Use --without-xpm to suppress this feature.
839
840 --with-xterm-symlink=XXX make symbolic link to installed xterm
841
842 If any of the configure options to modify the program name i.e.,
843 --program-prefix, --program-suffix or --program-transform-name
844 are given, this option allows the makefile to create a symbolic link,
845 e.g., to "xterm" on install. The option value gives the name for
846 the link, which defaults to "xterm".
847
848 Use --without-xterm-symlink to disable a link to "xterm" if none
849 is wanted.
850
851 Corresponding links are also made for "resize", "uxterm" and
852 "koi8rxterm", as well as the xterm manpage.
853
854 --with-terminal-id[=V] set default decTerminalID (default: vt100)
855
856 Set the default emulation level.
857
858 DEC terminals vt52/vt100/vt220/etc form a series where succeeding
859 models emulate features of the older terminals. While most
860 features of these terminals are recognized by xterm at all levels,
861 a few behave differently according to the emulation level.
862
863 You can always override this with the command-line option "-ti".
864
865 --with-terminal-type=T set default $TERM (default: xterm)
866
867 Set the default value for $TERM. Xterm supports legacy termcap
868 applications by constructing a modified version of the $TERMCAP
869 variable at initialization, which supplies the resulting screen
870 size. It also sets $TERM, if not already set, for use by programs
871 running within xterm.
872
873 The default value "xterm", can be overridden to avoid conflict
874 with older versions of xterm, e.g., those that do not implement
875 vt220 emulation.
876
877 You can always override this with the command-line option "-tn".
878
879 --with-utempter use utempter library for access to utmp
880
881 The utempter library is a set-uid wrapper for the utmp facility.
882 On systems with Unix98 pty's, xterm can use this library when
883 available so it need not be installed set-uid.
884
885 --with-utmp-setgid=XXX use setgid for access to utmp
886
887 The option value specifies a group to use when installing.
888 xterm will be installed with setgid privilege to this group.
889 At runtime, xterm will drop the setuid privilege immediately
890 after opening the pseudo-terminal, and will have only the
891 group privilege needed to access the utmp file. This relies
892 on having POSIX setuid behavior.
893
894 -- vile:txtmode