1 -- $XTermId: INSTALL,v 1.196 2025/01/03 00:54:45 tom Exp $ 2 ------------------------------------------------------------------------------- 3 -- Copyright 1997-2024,2025 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-initial-erase disable setup for stty erase 202 203 Do not compile-in code which aligns the stty erase and the backarrow 204 key. When compiled-in, xterm will optionally use the pty's sense 205 of stty erase and apply that to the backarrow mode (sending 8 or 127), 206 or go the other way, setting stty erase to match xterm's configuration. 207 208 --disable-input-method disable input-method 209 210 Do not compile-in code for "input method". This is an X11R6 211 feature which deals with translation of composite characters. 212 213 Some users report problems with their configuration, e.g., messages 214 stating that there is no input method defined for the given preedit 215 type. If you do not need input method (and are troubled by the 216 warning messages), it is safe to disable this option. 217 218 --disable-leaks test: free permanent memory, analyze leaks 219 220 Compile-in code which frees memory which might confuse a leak-testing 221 tool. Normally these chunks of memory are retained as long as xterm 222 is running. 223 224 --disable-luit disable support for luit filter (Unicode translation) 225 226 Luit is a filter that can be run between an arbitrary application and a 227 UTF-8 terminal emulator. It will convert application output from the 228 locale's encoding into UTF-8, and convert terminal input from UTF-8 229 into the locale's encoding. 230 231 This is normally enabled, relying upon "--enable-wide-chars". 232 233 --disable-maximize disable actions for iconify/deiconify/maximize/restore 234 235 Do not compile-in code that implements runtime 'actions' for 236 iconifying, maximizing, etc. 237 238 Most users will find that the window manager is more suitable for 239 this sort of manipulation than putting the capabilities into xterm. 240 241 --disable-num-lock disable NumLock keypad support 242 243 Do not compile-in code that looks for the actual NumLock key to 244 support vt100/vt220 keypad translation. 245 246 This is used in xterm to simplify logic, and to workaround some 247 quirks of the keyboard tables. Use the ``numLock'' resource to 248 disable this feature if you must customize xterm in some other way. 249 250 (The same ifdef controls the metaSendsEscape support). 251 252 --disable-openpty disable openpty, prefer other interfaces 253 254 Do not check for, or use openpty(). Instead, use other interfaces such 255 as posix_openpt(). Modern (sic) BSD systems should have a workable 256 openpty() interface. Older systems may not. 257 258 --disable-paste64 disable support for bracketed paste mode 259 260 Do not compile-in code to support bracketed paste mode, along with 261 functions for setting/getting the selection data, termed "paste64". 262 263 (see ctlseqs.ms description of OSC 52, and DECSET 2004). 264 265 --disable-print-graphics disable screen dump to sixel support 266 267 Do not compile-in code to support screen-dumps for ReGIS graphics. 268 269 --disable-pty-handshake disable support for pty handshakes 270 271 This feature is used to ensure that the child process's terminal modes 272 match the parent's. In particular, it addresses a problem where the 273 terminal size is not defined in the stty settings. 274 275 --disable-rectangles disable VT420 rectangle support 276 277 Do not compile-in code to support VT420 rectangle control-sequences. 278 279 --disable-regex disable regular-expression selections 280 281 Do not compile-in code to support the "regex" option for multiple 282 mouse clicks. 283 284 --disable-rightbar disable right-scrollbar support 285 286 Do not compile-in code that supports a scrollbar on the right. 287 288 Left/right scrollbars are a matter of taste. Some older libraries 289 (e.g., X11R5) do not perform the geometry computation correctly, 290 leaving the right scrollbar incorrectly positioned after changing 291 the font size. 292 293 --disable-readline-mouse enable support for mouse in readline applications 294 295 Do not compile-in code to support readline with mouse. 296 297 (The "paste64" feature, which fits xterm's protocol better, is 298 configured by default). 299 300 --disable-rpath-hack don't add rpath options for additional libraries 301 302 By default, the configure script looks for libraries in unusual places 303 and adds an rpath linker option to help. 304 305 --disable-samename disable check for redundant name-change 306 307 Do not compile-in code that suppresses redundant updates to the 308 titlebar when the text has not changed. 309 310 --disable-screen-dumps disable XHTML and SVG screen dumps 311 312 Do not compile-in code that provides XHTML and SVG screen dumps. 313 314 --disable-selection-ops disable selection operations 315 316 Do not compile-in code to support the actions which allow users 317 to bind keys that use the selection or extract data from the screen. 318 319 --disable-session-mgt enable support for session management 320 321 Do not compile-in code which adds simple session management hooks 322 which are used when closing an xterm. Normally the code is 323 compiled-in, except for systems which do not support it. 324 325 --disable-setgid disable setgid 326 327 Do not install xterm using setuid/setgid permissions. Drop setgid 328 permissions on startup. 329 330 --disable-setuid disable setuid 331 332 Do not install xterm using setuid/setgid permissions. Drop setuid 333 permissions on startup. 334 335 --disable-sixel-graphics disable support for sixel-graphics 336 337 Do not compile-in code to support sixel-graphics 338 339 --disable-sun-fkeys 340 341 Do not compile-in code to support Sun-style function keys. 342 343 --disable-tcap-fkeys disable termcap function-keys 344 345 Do not compile-in code to support feature which allows xterm to use the 346 function-key definitions from the termcap/terminfo entry which it used 347 to set the $TERM variable on startup. 348 349 --disable-tcap-query disable termcap query/report 350 351 Do not compile-in code to support DCS '+' control sequence, which 352 allows an application to ask xterm what control sequences it would 353 transmit for specified function keys, given the termcap or terminfo 354 names. 355 356 --disable-tek4014 disable tek4014 emulation 357 358 Do not compile-in code to support Tektronix 4014 emulation. 359 360 This reduces the executable size by 17% (checked 1999/3/13). 361 362 Some people use the Tektronix emulation (which has been in xterm 363 for many years) as an example of code bloat, though this is not an 364 accurate impression. 365 366 --disable-vt52 disable VT52 emulation 367 368 Do not compile-in code to support vt52 emulation. 369 370 A genuine vt100 emulates a vt52. 371 372 --disable-wide-attrs disable wide-attribute support 373 374 Xterm's base attributes include all of those used in DEC terminals. 375 ISO 6429 defines a few more which historically have found little use. 376 Some people find these amusing. 377 378 This is normally enabled. The direct-colors feature relies upon it. 379 380 --disable-wide-chars disable wide-character support 381 382 The wide-character code supports Unicode and UTF-8. 383 384 This is normally enabled. 385 386 --disable-xcursor disable cursorTheme resource 387 388 Do not compile-in code that sets the XCURSOR_THEME environment variable 389 to enable/disable cursor themes. 390 391 --disable-ziconbeep disable -ziconbeep option 392 393 Do not compile-in code that modifies the icon's title and sounds a 394 beep when they receive output. 395 396 --enable-16bit-chars enable 16-bit characters support 397 398 Enable wide-character support, but store only 16-bits for each wide 399 character. Unicode values can be larger than 16-bits, up to 21-bits. 400 This uses less memory, but is less complete. However, most languages 401 are covered by the 16-bit encoding. 402 403 --enable-alt-sends-esc set default altSendsEscape resource (default: no) 404 405 This sets the default resource value, which is shown in the manpage. 406 407 --enable-backarrow-key set default backarrowKey resource (default: true) 408 409 This sets the default resource value, which is shown in the manpage. 410 411 --enable-backarrow-is-erase set default backarrowKeyIsErase resource (default: false) 412 413 This sets the default resource value, which is shown in the manpage. 414 415 --enable-block-select allow block-selections 416 417 Compile-in code to support block selections, which are normally bound 418 to meta-button1. 419 420 --enable-broken-osc allow broken Linux OSC-strings 421 422 Compile-in code to accommodate scripts that write Linux's malformed 423 palette control strings without checking. The result makes xterm 424 appear to freeze. This workaround makes xterm ignore the strings, 425 and is compiled-in by default for Linux. 426 427 --enable-builtin-xpms compile-in icon data 428 429 Compile-in X pixmap data for these icons: 430 filled-xterm 431 mini.xterm 432 xterm-color 433 xterm 434 at these sizes 435 16x16 436 32x32 437 48x48 438 439 --enable-dabbrev enable dynamic-abbreviation support 440 441 Compile-in support for "dabbrev-expand()" action and related key 442 translation. 443 444 --enable-dec-locator enable DECterm Locator support 445 Add support for DEC Locator control sequences for xterm: 446 447 DECEFR - Enable Filter Rectangle 448 DECELR - Enable Locator Reports 449 DECSLE - Select Locator Events 450 DECRQLP - Request Locator Position 451 452 This allows the xterm mouse to be used with applications that use the 453 DEC Locator sequences, such as VAX Tpu, or SMG$ based applications. 454 455 --enable-delete-is-del set default deleteIsDEL resource (default: maybe) 456 457 This sets the default resource value, which is shown in the manpage. 458 459 --enable-double-buffer enable double-buffering 460 461 Set the initial value of the "buffered" resource, which tells 462 xterm to use double-buffering for display to reduce flicker. 463 464 --enable-env-terminfo setenv $TERMINFO if --with-own-terminfo gives value 465 466 Use the custom terminfo directory specified in "--with-own-terminfo" 467 as the $TERMINFO variable for the shells spawned by xterm. Setting 468 this variable makes most curses (and termcap) applications look in 469 that directory for terminal descriptions. 470 471 --enable-exec-xterm enable "spawn-new-terminal" action 472 473 If your platform supports the process filesystem "cwd" link, 474 compile-in support for the "spawn-new-terminal" action, which 475 allows you to define a key translation that runs a new xterm 476 using the same working directory as the current process within 477 xterm. 478 479 --enable-hp-fkeys enable support for HP-style function keys 480 481 Compile-in code to support HP-style function keys. 482 483 --enable-imake enable use of imake for definitions 484 485 Attempt to use imake to determine compiler options. 486 487 The main.c file has many ifdef's which rely on obscure combinations 488 known only to imake. The configure script implements only a 489 portion of the tests needed to supplant imake. 490 491 --enable-load-vt-fonts enable load-vt-fonts() action 492 493 Compile-in code that allows user to define load different VT-font 494 definitions at runtime. 495 496 --enable-logfile-exec enable exec'd logfile filter 497 498 Compile-in code that allows logging piped via an external filter. 499 500 --enable-logging enable logging 501 502 Compile-in code that allows logging. 503 504 Logging was disabled in X11R5 xterm because of security problems. 505 They were addressed in X11R6, but the feature was not reinstated 506 because of concerns (long past) about xterm running as root-setuid. 507 508 --enable-meta-sends-esc set default metaSendsEscape resource (default: no) 509 510 This sets the default resource value, which is shown in the manpage. 511 512 --enable-mini-luit enable support for poor man's luit filter (Latin-9) 513 514 Provide built-in support for Latin-9, relying on having specified 515 Unicode (ISO10646) fonts and setting the locale resource to "checkfont". 516 517 This sets "--enable-luit" as a side-effect. 518 519 --enable-narrowproto enable narrow prototypes for X libraries 520 521 Originally xterm was built using imake rather than a configure script. 522 One feature of imake that is not possible to guess within the 523 configure script is the wide-prototype compile-time definition 524 NARROWPROTO. When this is not set properly, the Athena widget 525 scrollbars do not work properly. xterm's configure script has a 526 fallback case which allows disabling imake. However, this is moot 527 with the X.org "modular" build, whose compiler options are unrelated to 528 imake or older versions of any libraries that it may distribute. In 529 this case, the configure script needs some help. Use this option to 530 enable or disable NARROW proto (and do not enable imake with the 531 --enable-imake option) to match the whims of X.org hackers. 532 533 For instance 534 535 configure --disable-narrowproto 536 537 --enable-pty-erase set default ptyInitialErase resource (default: false) 538 539 This sets the default resource value, which is shown in the manpage. 540 541 --enable-regis-graphics enable support for ReGIS graphics 542 543 Compile-in code to support experimental ReGIS graphics 544 545 --enable-sco-fkeys enable support for SCO-style function keys 546 547 Compile-in code to support SCO-style function keys. 548 549 --enable-status-line enable support for status-line 550 551 Compile-in code to enable VT220-VT525 support for status-line. 552 553 --enable-stdnoreturn enable C11 _Noreturn feature for diagnostics 554 555 Use the C11 _Noreturn keyword if the compiler supports it, rather 556 than the gcc-specific __attribute__((noreturn)). 557 558 --enable-toolbar enable pulldown menus on toolbar 559 560 Compile-in code that builds a toolbar with pulldown menus. The 561 normal popup menus are still available. 562 563 This is an experimental option. As of patch #206, it is known to 564 work well with fvwm, but not as well with some other window managers, 565 e.g., KDE's Kwin and IceWM. 566 567 In addition to isolated layout problems, it is reported that some 568 flavors of the Athena widget library perform badly with ISO-10646 569 fonts. You can work around those by setting the menu fonts to 570 an ISO-8859 variant in your X resources. 571 572 --enable-trace test: set to enable debugging traces 573 574 Compile-in code to trace xterm's internal states. 575 576 This is a debugging feature. It causes xterm to produce two files 577 (Trace-parent.out and Trace-child.out). 578 579 --enable-warnings test: turn on GCC compiler warnings 580 581 Modify the generate Makefile to turn on gcc compiler warnings. 582 583 I use this option regularly, and correct all but a few (difficult) 584 problems. 585 586 --enable-xmc-glitch test: enable xmc magic-cookie emulation 587 588 Compile-in code that simulates the terminfo "magic cookie" glitch. 589 590 This is for testing ncurses. 591 592 --with-Xaw3d link with Xaw 3d library 593 594 Look for, compile and link with the Xaw 3d widget library. 595 596 --with-Xaw3dxft link with Xaw 3d xft library 597 598 Look for, compile and link with the Xaw 3d xft widget library. 599 600 --with-XawPlus link with Athena-Plus library 601 602 Look for, compile and link with the Xaw Plus widget library. 603 604 --with-app-class=XXX X resource class (default: XTerm) 605 606 Rename the X resource class, e.g., for packaging a development version 607 of xterm with different result names. 608 609 --with-app-defaults=DIR directory in which to install resource files (default: EPREFIX/lib/X11/app-defaults) 610 611 autoconf scripts assume that all of the files should be installed 612 under the same top-level directory. But X applications defaults 613 must be installed into a special directory, e.g., 614 615 /usr/X11/lib/app-defaults 616 617 However, there is no standard for this pathname. The manual page 618 for X notes that the environment variable $XUSERFILESEARCHPATH can 619 specify a list of places where X searches for applications defaults. 620 Also, it may look in $XAPPLRESDIR, but that usually is not related 621 to where xterm might be installed. To keep it simple, the configure 622 script uses 623 624 EPREFIX/lib/X11/app-defaults 625 626 as the default (EPREFIX is --prefix). That makes it work normally 627 for most systems if --prefix is /usr. For other installs, e.g., to 628 /usr/local, you should use this option to customize the location to 629 match your system configuration. 630 631 Use --with-app-defaults=auto to ask the configure script to look in 632 a list of well-known locations for an existing directory. 633 634 Use --without-app-defaults or --with-app-defaults=no to disable the 635 feature. 636 637 --with-dmalloc test: use Gray Watson's dmalloc library 638 639 Check for and link with dmalloc. 640 641 --with-dbmalloc test: use Conor Cahill's dbmalloc library 642 643 Check for and link with dbmalloc. 644 645 --with-desktop-category=XXX one or more desktop categories or auto 646 This is a list of names. The configure script maps blanks and commas 647 to semicolons (";") which are used by the desktop utilities as a 648 separator. 649 650 The default value "auto" tells the configure script to look 651 at existing ".desktop" files for xterm and common terminal 652 emulators, to use those. If none are found, the script uses this 653 default: 654 System;TerminalEmulator; 655 656 --with-freetype-config configure script to use for FreeType 657 658 Use a specific option value to tell the configure script to try 659 just one of the variations: 660 661 "pkg*", e.g., pkg-config or pkgconfig uses whatever pkg-config 662 script was found. 663 664 otherwise, the parameter value is used as the name of the script 665 to try, using --cflags and --libs options. 666 667 Use --without-freetype-config to enable the --with-freetype-cflags 668 and --with-freetype-libs options. 669 670 The default value "auto" tells the configure script to try the 671 pkg-config script first, then freetype-config and finally xft-config. 672 673 --with-freetype-cflags -D/-I options for compiling with FreeType library 674 675 Override options provided by xft-config or freetype-config. 676 677 --with-freetype-libs -L/-l options for linking with FreeType library 678 679 Override options provided by xft-config or freetype-config. 680 681 --with-icon-name[=NAME] override icon name (default: xterm-color) 682 683 xterm comes with a choice of icons: 684 685 xterm-color: depicts a conventional terminal image, and is the default 686 icon used for icon-themes. 687 688 mini.xterm: a more iconic choice which is readily identifiable at 689 small sizes. This is used for window decoration, e.g., the 690 icon at the upper left corner in many window managers. 691 692 --with-icon-symlink[=NAME] create symbolic links to icon name (default: NONE) 693 694 This is a workaround for certain systems which translate icon names 695 containing "xterm", e.g., "xterm-color" into the single icon "xterm". 696 The option should also be harmless on a properly configured system. 697 698 If the option is used, its default value is "xterm". For each icon, 699 the makefile will strip the suffix (e.g., ".png"), as well as the part 700 of the filename which denotes the size (e.g., "_32x32" in an xpm file), 701 and constructs a link with that name to the icon. 702 703 If the option is unused, its default value is "NONE" (no link is made). 704 705 --with-icondir=DIR directory in which to install icon files (default: no) 706 707 The X libraries may automatically search these locations: 708 709 $HOME/.icons 710 $XDG_DATA_DIRS/icons 711 /usr/share/pixmaps 712 713 Alternatively, the last may be actually 714 /usr/X11R6/share/pixmaps 715 716 Use --with-icondir=auto to tell the configure script to search for 717 an existing directory from its list of well-known system locations. 718 719 See also 720 http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html 721 http://www.freedesktop.org/software/icon-theme/ 722 723 By default, the option is disabled; it is useful only for the 724 --with-icon-theme option. 725 726 --with-icon-theme[=XXX] install icons into desktop theme (hicolor) 727 728 Install png and svg icons into the given desktop theme and customize 729 the .desktop files to use that theme. If no theme name is given, 730 the default is "hicolor". If this option is not given, the desktop 731 file will use the pixmap files. 732 733 --with-man2html[=XXX] use XXX rather than groff 734 735 Specify an alternative program to use for converting manpages and 736 control sequences document to html. The default value for the option 737 is "man2html". If the "man2html" script is not found, then "groff" is 738 used with groff's special options. 739 740 The "man2html" script reads formatted nroff output from its standard 741 input, and writes html to its standard output. Other input/output 742 conventions are not currently supported. 743 744 See 745 http://invisible-island.net/scripts 746 http://invisible-island.net/scripts/man2html.html 747 748 for an up-to-date version of "man2html". 749 750 --with-neXtaw link with neXT Athena library 751 752 Look for, compile and link with the neXT Athena widget library. 753 754 --with-own-terminfo[=P] set default $TERMINFO (default: from environment) 755 756 Modify the generated Makefile to set the target for the 'install-ti' 757 rule to point to the given directory. 758 759 If you have the $TERMINFO variable defined in your environment, the 760 configure script may use that value, if it matches an existing 761 directory. If no option and no variable are are given, the configure 762 script uses /usr/lib/terminfo, if it exists. 763 764 You do not have to run "make install-ti", if there is already a 765 workable terminfo description. Be advised, however, that the 766 common variety of "xterm-color" is not suited for xterm, but is 767 directed to other variations (such as nxterm) which do not 768 support the background-color erase capability. 769 770 --with-pixmapdir=DIR directory in which to install pixmaps (DATADIR/pixmaps) 771 772 Specify directory in which to install ".xpm" files. 773 774 --with-pcre use PCRE for regular-expressions 775 776 If regular expressions are not disabled (--disable-regex), use PCRE 777 rather than the POSIX regular expressions. 778 779 --with-pcre2 use PCRE2 for regular-expressions 780 781 If regular expressions are not disabled (--disable-regex), use PCRE2 782 rather than the POSIX regular expressions. 783 784 --with-pkg-config{=path} enable/disable use of pkg-config 785 786 The configure script looks for certain libraries which have well 787 established pkg-config scripts, and will use those settings if 788 available. Not all pkg-config scripts work; this option suppresses 789 the check and relies on normal library search paths. 790 791 --with-reference=XXX program to use as permissions-reference 792 793 To install xterm with setuid permissions, the scripts usually compare 794 it with a previous install. That works well for individual 795 maintainers, but can be a problem for packagers who may be 796 cross-compiling, etc. This option lets the package builder specify 797 the file used for permissions reference. 798 799 --with-setuid[=XXX] use the given setuid user 800 801 Install xterm setuid'd to the given user. If no parameter value 802 is given, assume it is root. 803 804 See also --with-utmp-setgid and --with-utempter, which manipulate 805 the setgid group. 806 807 --with-tty-group[=XXX] use XXX for the tty-group 808 809 If xterm is installed setuid'd to root, change the group of the tty 810 device to the given value on startup. Three cases are possible: 811 812 a) If this option is not given, the configure script will attempt to 813 find a suitable value (usually "tty"), and verify that it exists in 814 the group database. 815 816 b) If the option value is given, it will use the value even if it does 817 not exist in the group database (allowing packagers to work about 818 deficient environments). 819 820 c) If the option is disabled, e.g., --without-tty-group, the 821 permissions change will use the group-id of the process. 822 823 If xterm is not installed setuid'd to root, this option is not needed, 824 since it cannot change the tty device's ownership. 825 826 --with-utmp-path use XXX rather than auto for utmp path 827 828 The pathname for the "utmp" file is documented in the manual page. 829 Because this is system-dependent, and xterm may be built on a machine 830 which has no desktop, that file may be absent (and the configure script 831 may give incorrect information). Use this option to override the value 832 that the configure script uses. 833 834 --with-valgrind test: use valgrind 835 836 Activate the --disable-leaks option, and ensure that "-g" is added to 837 CFLAGS. 838 839 --with-wtmp-path use XXX rather than auto for wtmp path 840 841 The pathname for the "wtmp" file is documented in the manual page. 842 Because this is system-dependent, and xterm may be built on a machine 843 which has no desktop, that file may be absent (and the configure script 844 may give incorrect information). Use this option to override the value 845 that the configure script uses. 846 847 --without-xinerama do not use Xinerama extension for multiple screens 848 849 Xinerama is an X server extension that allows multiple physical 850 screens to behave as a single screen. If you do not need the feature 851 (or do not want the extra library dependency), use this option to 852 suppress it. 853 854 --with-xpm[=DIR] use Xpm library for colored icon, may specify path 855 856 Use Xpm library to show colored icon in window decoration, e.g., 857 title area. 858 859 Use --without-xpm to suppress this feature. 860 861 --with-xterm-symlink[=XXX] make symbolic link to installed xterm 862 863 If any of the configure options to modify the program name i.e., 864 --program-prefix, --program-suffix or --program-transform-name 865 are given, this option allows the makefile to create a symbolic link, 866 e.g., to "xterm" on install. The option value gives the name for 867 the link, which defaults to "xterm". 868 869 Use --without-xterm-symlink to disable a link to "xterm" if none 870 is wanted. 871 872 Corresponding links are also made for "resize", "uxterm" and 873 "koi8rxterm", as well as the xterm manpage. 874 875 --with-terminal-id[=V] set default decTerminalID (default: vt100) 876 877 Set the default emulation level. 878 879 DEC terminals vt52/vt100/vt220/etc form a series where succeeding 880 models emulate features of the older terminals. While most 881 features of these terminals are recognized by xterm at all levels, 882 a few behave differently according to the emulation level. 883 884 You can always override this with the command-line option "-ti". 885 886 --with-terminal-type=T set default $TERM (default: xterm) 887 888 Set the default value for $TERM. Xterm supports legacy termcap 889 applications by constructing a modified version of the $TERMCAP 890 variable at initialization, which supplies the resulting screen 891 size. It also sets $TERM, if not already set, for use by programs 892 running within xterm. 893 894 The default value "xterm", can be overridden to avoid conflict 895 with older versions of xterm, e.g., those that do not implement 896 vt220 emulation. 897 898 You can always override this with the command-line option "-tn". 899 900 --with-utempter use utempter library for access to utmp 901 902 The utempter library is a set-uid wrapper for the utmp facility. 903 On systems with Unix98 pty's, xterm can use this library when 904 available so it need not be installed set-uid. 905 906 --with-utmp-setgid[=XXX] use setgid for access to utmp 907 908 The option value specifies a group to use when installing. 909 xterm will be installed with setgid privilege to this group. 910 At runtime, xterm will drop the setuid privilege immediately 911 after opening the pseudo-terminal, and will have only the 912 group privilege needed to access the utmp file. This relies 913 on having POSIX setuid behavior. 914 915 -- vile:txtmode 916
Indexes created Fri Jun 12 00:25:51 UTC 2026