1XCOMM $XFree86: xc/config/cf/xf86site.def,v 3.186 2003/06/25 18:06:22 eich Exp $
2/******************************************************************************/
3/*
4 * This file is to provide a quick method for most people to change the
5 * behaviour of their Xorg installation without having to fully
6 * understand the workings of site.def and all the various '.cf' files.
7 *
8 * In the vast majority of cases, it should not be necessary to use this
9 * file at all or change it in any way.
10 *
11 * This file is divided into two sections.  The first contains settings
12 * that end-users might reasonably change.  The second contains settings
13 * that developers might want to change.
14 *
15 * IMPORTANT NOTE:  In all cases changing the defaults may cause problems
16 * and/or unexpected side-effects.  If you don't understand what a setting
17 * does, then it's best to not change it.  If you make changes and have
18 * problems, verify that those problems are also present when using an
19 * empty host.def file and unchanged version of this file before reporting
20 * them.
21 *
22 * A good way to use this file is to copy it to host.def, and make the
23 * changes there.  That way, future patches to this file won't fail.
24 * The host.def file will never be patched.
25 *
26 * The distributed version of this file MUST contain no uncommented
27 * definitions.  Default definitions belong in xorg.cf, or <vendor>.cf
28 * files.
29 */
30/******************************************************************************/
31
32/*
33 * If you have build-specific modifications in your host.def file, but
34 * want an empty host.def file installed when doing 'make install',
35 * uncomment the following
36 *
37#define InstallEmptyHostDef
38 */
39
40/*
41 * Which servers to build.  There is only Xorg server.
42 * It can be disabled by the following.
43 *
44#define XorgServer		NO
45 */
46
47/*
48 * To disable building the Xnest server, uncomment this.
49 *
50#define XnestServer		NO
51 */
52
53/*
54 * To disable building Xvfb, uncomment this.
55 *
56#define XVirtualFramebufferServer	NO
57 */
58
59/*
60 * To enable building Xdmx, uncomment this.
61 *
62#define XdmxServer YES
63 */
64
65/*
66 * To disable building Xprt, uncomment this.
67 *
68#define XprtServer NO
69 */
70
71/*
72 * Set the default server (ie the one that gets the sym-link to "X")
73 *
74#define ServerToInstall		Xorg
75 */
76
77/*
78 * If you only run the X server under xdm the X servers don't need to be
79 * installed SetUID, and you may comment out the lines below.  If you run
80 * the servers by hand (with xinit or startx), then they do need to be
81 * installed SetUID on most platforms.
82 *
83 * Consult your system administrator before making the X server setuid.
84 *
85#define InstallXserverSetUID	NO
86 */
87
88
89/*
90 * Server configuration parameters.  The defaults are shown here:
91 */
92
93/*
94 * Which drivers to build.  When building a static server, each of these
95 * will be included in it.  When building the loadable server each of these
96 * modules will be built.
97 *
98#define XF86CardDrivers		mga glint nv tga s3virge sis rendition \
99				neomagic i740 tdfx savage \
100				cirrus vmware tseng trident chips apm \
101				GlideDriver fbdev i128 \
102				ati DevelDrivers ark cyrix \
103				siliconmotion \
104				vesa vga XF86OSCardDrivers XF86ExtraCardDrivers
105 */
106
107/*
108 * To add third party drivers to the standard driver list, set the
109 * following.
110 *
111#define XF86ExtraCardDrivers	extradriver1 extradriver2 ...
112 */
113
114/*
115 * Select the XInput devices you want by uncommenting this.
116 *
117#define XInputDrivers		mouse keyboard acecad calcomp citron \
118				digitaledge dmc dynapro elographics \
119				microtouch mutouch penmount spaceorb summa \
120				wacom void magictouch aiptek
121 */
122
123/* To enable building of development DRI drivers (insecure, or not
124 * useful on the chosen architecture, uncomment this define.
125#define BuildDevelDRIDrivers YES
126 */
127
128/*
129 * To use the deprecated, old keyboard driver, uncomment this.  But
130 * even better, make the new keyboard driver (hw/xfree86/input/keyboard)
131 * work for your architechture.  The old driver will be removed in the
132 * next release.
133 *
134#define UseDeprecatedKeyboardDriver YES
135 */
136
137/*
138 * There are three parameters that determine where and how the Matrox HAL
139 * library is used:
140 *
141 *   HaveMatroxHal  -- You have the HALlib.a binary library installed
142 *                     in xfree86/drivers/mga/HALlib, and you want it to
143 *                     be used.
144 *                     Default: NO
145 *
146 *   BuildMatroxHal -- You have the source for the HALlib library (installed
147 *                     in xfree86/drivers/mga/hallib), and want to build and
148 *                     use it.
149 *                     Default: NO
150 *
151 *   UseMatroxHal   -- You want to build support for loading/using the HAL
152 *                     library into the mga driver.  For module server builds
153 *                     you don't need to have the HALlib library to do this.
154 *                     but you want to build support for loading it and using
155 *                     it into the mga driver module.
156 *                     Default: YES for loadable server build
157 *                              (HaveMatroxHal || BuildMatroxHal) for static
158 */
159
160/*
161 * To disable use of the Matrox HAL library, uncomment this:
162 *
163#define UseMatroxHal		NO
164 */
165
166/*
167 * If you have the HALlib.a binary installed in xfree86/drivers/mga/HALlib,
168 * uncomment this:
169 *
170#define HaveMatroxHal		YES
171 */
172
173/*
174 * If you have the HALlib source code installed in xfree86/drivers/mga/hallib,
175 * uncomment this:
176#define BuildMatroxHal		YES
177 */
178
179/*
180 * To disable building the font server, uncomment this.
181 *
182#define BuildFontServer		NO
183 */
184
185/*
186 * Speedo fonts have been disabled by default in this release.
187 * To re-enable support for Speedo fonts, uncomment this.
188 *
189#define BuildSpeedo		YES
190 */
191
192/*
193 * To disable support for CID fonts, uncomment this.
194 *
195#define BuildCID		NO
196 */
197
198/*
199 * To disable support for TrueType fonts, uncomment these.
200 *
201#define BuildFreeType		NO
202 */
203
204/*
205 * To set non-default build options for the underlying FreeType libraries,
206 * add them here and uncomment.
207 *
208#define Freetype2BuildDefines	-DFREETYPE_BUILD_DEFINES
209 */
210
211/*
212 * To build the FreeType libraries with the TrueType byte code interpreter
213 * enabled, uncomment this.  Note that there are patent issues related to the
214 * TrueType byte code interpreter, and we only recommend you enabling this
215 * if you are sure that there are no legal impediments to you doing so.  See
216 * <http://www.freetype.org/patents.html> for further information.
217 *
218#define Freetype2BuildDefines -DTT_CONFIG_OPTION_BYTECODE_INTERPRETER
219 */
220
221/*
222 * Do you want to Build Fonts (Usually you only want to build and install
223 * fonts once, if this is a first time install you will want to build the
224 * fonts)
225 *
226#define BuildFonts		NO
227 */
228
229/*
230 * To not build/install the 75dpi fonts, uncomment the following
231 *
232#define Build75DpiFonts		NO
233 */
234
235/*
236 * To not build/install the 100dpi fonts, uncomment the following
237 *
238#define Build100DpiFonts	NO
239 */
240
241/*
242 * To build/install the Speedo fonts, uncomment the following
243 * (see setting above about Speedo support as well)
244 *
245#define BuildSpeedoFonts	YES
246 */
247
248/*
249 * To not build/install the Type1 fonts, uncomment the following
250 *
251#define BuildType1Fonts		NO
252 */
253
254/*
255 * To not build/install the CID fonts, uncomment the following
256 *
257#define BuildCIDFonts		NO
258 */
259
260/*
261 * To not build/install the True Type fonts, uncomment the following
262 *
263#define BuildTrueTypeFonts	NO
264 */
265
266/*
267 * To not build/install the Cyrillic fonts, uncomment the following
268 *
269#define BuildCyrillicFonts	NO
270 */
271
272/*
273 * To not install the local font directory, uncomment the following
274 *
275#define MakeLocalFontDir	NO
276 */
277
278/*
279 * To build only the servers with a cut-down source tree, uncomment
280 * this.
281 *
282#define BuildServersOnly	YES
283 */
284
285/*
286 * By default, the sample config files for xinit, xdm and xfs are installed
287 * only when there is no pre-existing version installed.  Uncommenting the
288 * following lines will force the sample versions to be installed even if
289 * it means over-writing existing versions.
290 *
291#define InstallXinitConfig	YES
292#define InstallXdmConfig	YES
293#define InstallFSConfig		YES
294 */
295
296/*
297 * By default the application defaults files are always installed.
298 * Uncommenting the the following will prevent exising application
299 * defaults files from being over-written.
300 *
301#define InstallAppDefFiles	NO
302 */
303
304/*
305 * Undefine the following if you don't want to have config files and
306 * app-defaults installed in a separate directory (i.e. /etc/X11).
307 *
308#define UseSeparateConfDir NO
309 */
310
311/*
312 * To enable building the glide driver, you need to define
313 * HasGlide2 to YES and set the Glide2IncDir variable.
314 * HasGlide2 is per default NO.
315 *
316#define HasGlide2 YES
317 */
318
319/*
320 * Set the path to your Glide include files.
321 *
322#define Glide2IncDir /usr/include/glide
323 */
324
325/*
326 * Have glide 3?
327 *
328#define HasGlide3 YES
329 */
330
331/*
332 * Set the path to your Glide 3 include files.
333 *
334#define Glide3IncDir /usr/include/glide3
335 */
336
337
338
339/*
340 * Unless you're a developer you shouldn't need to change anything
341 * beyond this point.
342 */
343
344/*
345 * If you want to enable some developer settings, like more verbose
346 * compiler warnings, uncomment this.
347 *
348#define XFree86Devel	YES
349*/
350
351/*
352 * The default optimisation flags for GCC 2.x.  -fno-strength-reduce is
353 * here to work around a bug in -O2 for GCC 2.x on i386 platforms.
354 * If you are using a version that doesn't have this bug, you can
355 * uncomment the following line, and remove '-fno-strength-reduce'
356 * If you are building binaries for a 486, it may be beneficial to add
357 * -m486
358 *
359#define DefaultGcc2i386Opt	-O2 -fno-strength-reduce
360 */
361
362/*
363 * This allows the GCC warning flags to be set.  The default is shown here.
364 *
365#define GccWarningOptions -Wall -Wpointer-arith -Wstrict-prototypes \
366                          -Wmissing-prototypes -Wmissing-declarations \
367                          -Wredundant-decls -Wnested-externs
368 */
369
370/*
371 * Sun Compiler stuff..
372 *
373#define HasSunC                         YES
374#define HasSunCplusplus                 YES
375#define CplusplusCompilerMajorVersion   5
376#define CplusplusCompilerMinorVersion   0
377#define CCompilerMajorVersion           5
378#define CCompilerMinorVersion           0
379 */
380
381/*
382 * Optimized Sun Compiler Build.
383 *
384#define DefaultCDebugFlags              -xO4 -xtarget=pentium_pro
385#define OptimizedCDebugFlags            -xO4 -xtarget=pentium_pro
386 */
387
388/*
389 * Debuggable Sun Compiler Build.
390 * Note: This builds _EVERYTHING_ as debuggable
391 *
392#define DefaultCDebugFlags              -g -xs
393#define OptimizedCDebugFlags            -g -xs
394 */
395
396/*
397 * For Linux, this should match the Binutils version you have.  This example
398 * is for 2.6.0.7.  See linux.cf for the default setting.
399 *
400 * This should automatically get set correctly by imake.
401 *
402#define LinuxBinUtilsMajorVersion	26
403 */
404
405/*
406 * For Linux, these should match the libc version you have.  This example
407 * is for libc.5.4.x.  See linux.cf for the default setting.
408 *
409 * This should automatically get set correctly by imake.
410 *
411#define LinuxCLibMajorVersion	5
412#define LinuxClibMinorVersion	4
413 */
414
415/*
416 * If you want to use the GNU malloc library, uncomment this
417 *
418#define UseGnuMalloc		YES
419 */
420
421/*
422 * Set this to whatever is required to access the GNU malloc library.
423 * The default is '-lgmalloc' unless is specified in the OS's .cf file.
424 *
425#define GnuMallocLibrary	-L/usr/local/lib -lgmalloc
426 */
427
428/*
429 * To enable the internal Xserver malloc, uncomment this
430 *
431#define UseInternalMalloc	YES
432 */
433
434/*
435 * Some Linux releases don't have a libtermcap.  In this case you may need
436 * to uncomment the following
437 *
438#define TermcapLibrary		-lncurses
439 */
440
441/*
442 * Build a server that dynamically loads the modules by setting
443 * this to YES.  This defaults to YES on most platforms.  A static server
444 * can be built by setting this to NO.
445 *
446#define DoLoadableServer	NO
447 */
448
449/*
450 * This release defaults to building dlopen() style modules instead of the
451 * previously standard loader modules.
452 *
453 * Uncomment the following to return to the XFree86 custom loader modules.
454 *
455#define MakeDllModules		NO
456 */
457
458/*
459 * Build XAA.  This can be disabled with:
460 *
461#define XF86XAA			NO
462 */
463
464/*
465 * Build vgahw.  This can be disabled with:
466 *
467#define XF86VgaHw		NO
468 */
469
470/*
471 * Build xf1bpp.  This can be disabled with:
472 *
473#define XF1Bpp			NO
474 */
475
476/*
477 * Build xf4bpp.  This can be disabled with:
478 *
479#define XF4Bpp			NO
480 */
481
482
483/*
484 * BSD Console driver support (for FreeBSD and NetBSD).
485 *
486 * By default, support is included for pccons and pcvt for NetBSD, and
487 * pccons, syscons and pcvt for FreeBSD.
488 *
489 * To change the list of supported drivers, set the following parameter.
490 * Possible values are -DPCCONS_SUPPORT, -DSYSCONS_SUPPORT, -DPCVT_SUPPORT.
491 * The following example includes support for syscons and pcvt only.
492 *
493#define XFree86ConsoleDefines	-DSYSCONS_SUPPORT -DPCVT_SUPPORT
494 */
495
496/*
497 * To link the X server with a dynamic version of the Xfont library,
498 * uncomment this.
499 *
500#define XserverStaticFontLib	NO
501 */
502
503/*
504 * To enable binary compatibility with previous versions of the font
505 * encoding support, uncomment this.
506 *
507#define FontencCompatibility    YES
508 */
509
510/*
511 * To disable building XInput support, uncomment this
512 *
513#define BuildXInputExt		NO
514 */
515
516/*
517 * Uncomment this for joystick support.
518 *
519 * Note: Joystick support is broken, so don't enable this.
520 *
521#define JoystickSupport YES
522 */
523
524/*
525 * To disable the ScreenSaver Extension, uncomment this line.
526 *
527#define BuildScreenSaverExt	NO
528 */
529
530/*
531 * If you don't want to build Xinerama support, uncomment this.
532 *
533#define BuildXinerama		NO
534 */
535
536/*
537 * If you don't want to build support for the GLX extension, uncomment this.
538 *
539#define BuildGlxExt             NO
540 */
541
542/*
543 * If you want to build the xf86rush extension, uncomment this line.
544 * This isn't recommended.
545 *
546#define BuildXF86RushExt	YES
547 */
548
549/*
550 * If you want to build the client library for the xf86rush extension,
551 * uncomment this line.  This isn't recommended.
552 *
553#define BuildXF86RushLibrary	NO
554 */
555
556/*
557 * If you are running NetBSD 0.9C or later, and have the aperture driver
558 * installed, uncomment this.
559 *
560#define HasNetBSDApertureDriver	YES
561 */
562
563/*
564 * If you are running SVR3 and have the mmap driver installed (for linear
565 * framebuffer access) uncomment this.
566 *
567#define HasSVR3mmapDrv	YES
568 */
569
570/*
571 * If you are using an SVR3 (like ISC 4.x) which supports long file names,
572 * you can uncomment this to have manual pages installed under their
573 * full names
574 *
575#define ExpandManNames		YES
576 */
577
578/*
579 * For a POSIXized build on Interactive uncomment this
580 * Could be used with gcc 'till Version 2.6.3
581 * Should be used with gcc 2.7.2.
582 *
583#define UsePosix		YES
584 */
585
586/*
587 * If you don't want XDMAUTH support (if you don't have Wraphelp.c),
588 *  comment this out.
589 *
590 */
591#define HasXdmAuth		YES
592
593/*
594 * If you have Linux DECnet support, and want to build XFree86 with support
595 * for connections over DECnet, uncomment this.
596 *
597#define HasDECnet		YES
598 */
599
600/*
601 * To build static and shared libraries with debugging information, uncomment
602 * this. Assumes you have Gcc2.
603 * (If you don't have Gcc2, you can use the DebugLib{X11,Xt,Xaw,...} variables
604 * to build debugging versions of the libraries separately.)
605 *
606#define DebuggableLibraries	YES
607*/
608
609/*
610 * To forceably build static libraries in addition to shared libraries,
611 * uncomment this.
612 *
613#define ForceNormalLib		YES
614 */
615
616/*
617 * Uncomment this if your default tools (eg, gcc, ld, as, etc) are
618 * not the Linux ELF versions.
619 *
620#define LinuxElfDefault		NO
621 */
622
623/*
624 * To use ELF format shared libraries for supported OSs, uncomment this.
625 *
626 * For Linux the default setting of this is the same as the setting of
627 * LinuxElfDefault.
628 *
629 * For FreeBSD this should automatically be set correctly by imake.  Only
630 * change it here if you need to override the automatic setting.
631 *
632#define UseElfFormat		YES
633 */
634
635/*
636 * For FreeBSD/ELF (FreeBSD 3.0) it is possible to also build and install
637 * a.out compatibility libraries.  To enable that, uncomment this.
638 *
639#define BuildAoutLibraries	YES
640 */
641
642/*
643 * If you have trouble with make bombing out in Xlib, try uncommenting this.
644 * You will not get dependencies as a result, but better than nothing.
645 *
646#define MakeHashTableBug        YES
647 */
648
649/*
650 * If you do not want your man pages compress under SVR3 systems that
651 * support it, uncomment this.
652 *
653#define CompressManPages        NO
654 */
655
656/*
657 * If you have sgmlfmt (the XFree86 doctools package) and want to build
658 * formatted docs from the SGML source, uncomment this.
659 *
660#define HasSgmlFmt		YES
661 */
662
663/*
664 * To disable building some document formats, uncomment some of these.
665 *
666#define BuildLinuxDocText	NO
667#define BuildLinuxDocHtml	NO
668#define BuildLinuxDocPS		NO
669 */
670
671/*
672 * To install Japanese versions of the documentation uncomment this.
673 * Note: The Japanese documentation consists of a subset of the
674 * XFree86 3.1 docs.
675 *
676#define InstallJapaneseDocs	YES
677 */
678
679/*
680 * To build/install X specs docs, uncomment the following.
681 * The SpecsDocDirs setting here is recommended because it covers
682 * the docs that XFree86 has changed or added.
683 *
684#define BuildSpecsDocs		YES
685#define SpecsDocDirs		CTEXT GL ICCCM X11 Xext Xmu Xv XvMC i18n
686 */
687
688/*
689 * To build all specs docs, not just those listed in SpecsDocDirs, uncomment
690 * the following.
691 *
692#define BuildAllSpecsDocs	YES
693 */
694
695/*
696 * If your system doesn't support vm86() mode and you have
697 * libx86emu set library path here
698 *
699#define X86EMU_LIBPATH /usr/local/lib
700 */
701
702/*
703 * Most platforms default to using an already installed FreeType 2 library.
704 * To use the one included in this release instead, uncomment the following.
705 *
706#define HasFreetype2 NO
707 */
708
709/*
710 * To use a FreeType library already installed outside the default search
711 * paths, uncomment the following and set the path as needed.
712 *
713#define HasFreetype2 YES
714#define Freetype2Dir /usr/local
715 */
716
717
718/*
719 * Most platforms default to using an already installed Fontconfig library.
720 * To use the one included in this release instead, uncomment the following.
721 *
722#define HasFontconfig NO
723 */
724
725/*
726 * To use a Fontconfig library already installed outside the default search
727 * paths, uncomment the following and set the path as needed.
728#define HasFontconfig YES
729#define FontconfigDir /usr/local
730 */
731
732
733/*
734 * Most platforms default to using an already installed Expat library.
735 * To use the one included in this release instead, uncomment the following.
736 *
737#define HasExpat NO
738 */
739
740/*
741 * To use a Expat library already installed outside the default search
742 * paths, uncomment the following and set the path as needed.
743#define HasExpat YES
744#define ExpatDir /usr/local
745 */
746
747
748/*
749 * Most platforms default to using an already installed PNG library.
750 * To use the one included in this release instead, uncomment the following.
751 *
752#define HasLibpng NO
753 */
754
755/*
756 * To use a PNG library already installed outside the default search
757 * paths, uncomment the following and set the path as needed.
758#define HasLibpng YES
759#define LibpngDir /usr/local
760 */
761
762
763/*
764 * Most platforms default to using an already installed xterm program.
765 * To use the one included in this release instead, uncomment the following.
766 *
767#define BuildXterm YES
768 */
769