3 .\" Copyright (c) 2000 by Conectiva S.A. (http://www.conectiva.com)
5 .\" Permission is hereby granted, free of charge, to any person obtaining a
6 .\" copy of this software and associated documentation files (the "Software"),
7 .\" to deal in the Software without restriction, including without limitation
8 .\" the rights to use, copy, modify, merge, publish, distribute, sublicense,
9 .\" and/or sell copies of the Software, and to permit persons to whom the
10 .\" Software is furnished to do so, subject to the following conditions:
12 .\" The above copyright notice and this permission notice shall be included in
13 .\" all copies or substantial portions of the Software.
15 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 .\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 .\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 .\" CONECTIVA LINUX BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
19 .\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
20 .\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23 .\" Except as contained in this notice, the name of Conectiva Linux shall
24 .\" not be used in advertising or otherwise to promote the sale, use or other
25 .\" dealings in this Software without prior written authorization from
28 .\" Author: Paulo César Pereira de Andrade <pcpa@conectiva.com.br>
30 .\" $XFree86: xc/programs/Xserver/hw/xfree86/xf86cfg/xf86cfg.man,v 1.9 2002/12/30 14:34:02 herrb Exp $
32 .TH xorgcfg __appmansuffix__ __vendorversion__
34 xorgcfg - Graphical configuration tool for __xservername__
37 [-config \fIconfigfile\fP] [-modulepath \fImoduledir\fP]
38 [-fontpath \fIfontsdir\fP] [-toolkitoption ...]
41 is a tool to configure\fI __xservername__\fP, and can be used to either write the
42 initial configuration file or make customizations to the current configuration.
44 When the \fBDISPLAY\fP environment variable is not set, xorgcfg will run
45 the command\fI __xservername__ -configure\fP to allow the xserver to detect the
46 hardware in the computer, and write an initial\fI __xconfigfile__\fP file
47 in the user's home directory. Then, it will start
48 __xservername__ and allow customizations.
50 If the \fBDISPLAY\fP environment variable is set, xorgcfg will read the
51 default\fI __xconfigfile__\fP, which may or may not be the one being used by
52 the current server, and allow customizations.
54 To use an alternative location for modules or fonts the respective search
55 paths may be specified.
57 Unless there is an \fBApply\fP button in the current xorgcfg dialog, the
58 changes made will take place the next time\fI __xservername__\fP is started.
60 Xorgcfg allows addition and configuration of new devices, such as video cards,
61 monitors, keyboards and mouses.
63 Screen layout configuration for xinerama or traditional multi-head is also
66 Modelines can be configured or optimized.
68 AccessX basic configurations can be made in the xorgcfg's accessx section.
73 Specifies an alternate __xconfigfile__ file for configuration.
76 Specifies where xorgcfg, and the server it may start, should look for
77 __xservername__ modules.
80 Specifies the complete path, not including the binary name, of the
81 __xservername__ binary.
84 Specifies the path to the fonts that should be used by the server started
88 Specifies the path to the rgb.txt file that should be used by the server
89 started by xorgcfg, if any.
92 If xorgcfg was compiled with support for ncurses, this option makes xorgcfg
93 enter a text mode interface.
96 When built with support for loading modules, this options changes xorgcfg
97 behaviour, so that it will not load any modules, and thus start quicker.
102 Default host and display number.
105 Directory where __xservername__ was installed, defaults to __projectroot__.
108 Name of a resource file that overrides the global resources
109 stored in the RESOURCE_MANAGER property.
113 .I /etc/__xconfigfile__
114 Server configuration file
116 .I /etc/X11/__xconfigfile__
117 Server configuration file
119 .I __projectroot__/etc/__xconfigfile__
120 Server configuration file
122 .IR __projectroot__/lib/X11/__xconfigfile__. hostname
123 Server configuration file
125 .I __projectroot__/lib/X11/__xconfigfile__
126 Server configuration file
128 .I __projectroot__/lib/X11/app-default/XOrgCfg
129 Specifies xorgcfg resources
131 .I __projectroot__/lib/X11/xkb/X0-config.keyboard
132 Keyboard specific configuration
135 .IR __xservername__ (__appmansuffix__),
136 .IR __xconfigfile__ (__filemansuffix__)
140 Copyright 2000, Conectiva Linux S.A.
141 \fIhttp://www.conectiva.com\fP
143 Copyright 2000, The XFree86 Project
144 \fIhttp://www.XFree86.org\fP
148 Paulo C\'esar Pereira de Andrade \fI<pcpa@conectiva.com.br>\fP
149 originally for The XFree86 Project.