Cygwin/X: Man page fixes

Correct path names in man pages, using cpprules.in
Install XWinrc man page into section 5

Signed-off-by: Jon TURNEY <jon.turney@dronecode.org.uk>
This commit is contained in:
Yaakov Selkowitz 2009-01-05 16:17:30 +00:00 committed by Jon TURNEY
parent 5c1afac5ee
commit f351c10a97
3 changed files with 39 additions and 18 deletions

View File

@ -158,7 +158,7 @@ winprefsyacc.h: winprefsyacc.c
winprefslex.c: winprefslex.l winprefsyacc.c winprefsyacc.h winprefslex.c: winprefslex.l winprefsyacc.c winprefsyacc.h
BUILT_SOURCES = winprefsyacc.h winprefsyacc.c winprefslex.c BUILT_SOURCES = winprefsyacc.h winprefsyacc.c winprefslex.c
CLEANFILES = $(BUILT_SOURCES) CLEANFILES = $(BUILT_SOURCES) $(appman_DATA) $(fileman_DATA) XWin.man XWinrc.man
AM_YFLAGS = -d AM_YFLAGS = -d
AM_LFLAGS = -i AM_LFLAGS = -i
@ -166,15 +166,34 @@ AM_CFLAGS = -DHAVE_XWIN_CONFIG_H $(DIX_CFLAGS) \
$(XWINMODULES_CFLAGS) \ $(XWINMODULES_CFLAGS) \
-DXFree86Server -DXFree86Server
dist_man1_MANS = XWin.man XWinrc.man
GLX_EXTRAS = \ GLX_EXTRAS = \
glx/glwindows.h \ glx/glwindows.h \
glx/glwrap.c \ glx/glwrap.c \
glx/indirect.c glx/indirect.c
MAN_SRCS = XWin.man.pre XWinrc.man.pre
appmandir = $(APP_MAN_DIR)
appman_DATA = XWin.$(APP_MAN_SUFFIX)
filemandir = $(FILE_MAN_DIR)
fileman_DATA = XWinrc.$(FILE_MAN_SUFFIX)
XWin.$(APP_MAN_SUFFIX): XWin.man
-rm -f XWin.$(APP_MAN_SUFFIX)
$(LN_S) XWin.man XWin.$(APP_MAN_SUFFIX)
XWinrc.$(FILE_MAN_SUFFIX): XWinrc.man
-rm -f XWinrc.$(FILE_MAN_SUFFIX)
$(LN_S) XWinrc.man XWinrc.$(FILE_MAN_SUFFIX)
EXTRAMANDEFS = -D__logdir__=$(logdir) -D__sysconfdir__=$(sysconfdir) -D__datadir__=$(datadir)
include $(top_srcdir)/cpprules.in
EXTRA_DIST = \ EXTRA_DIST = \
$(GLX_EXTRAS) \ $(GLX_EXTRAS) \
$(MAN_SRCS) \
_usr_X11R6_lib_X11_system.XWinrc \ _usr_X11R6_lib_X11_system.XWinrc \
X-boxed.ico \ X-boxed.ico \
X.ico \ X.ico \

View File

@ -48,14 +48,14 @@ operations on the individual X windows.
.SH LOG .SH LOG
As it runs \fIXWin\fP writes messages indicating the most relevant events As it runs \fIXWin\fP writes messages indicating the most relevant events
to the console to the console
from which it was called and to a log file that by default is located at from which it was called and to a log file that by default is located at \fI
\fI/tmp/XWin.log\fP. This file is mainly for debugging purposes. __logdir__/XWin.0.log\fP. This file is mainly for debugging purposes.
.SH PREFERENCES FILE .SH PREFERENCES FILE
On startup \fIXWin\fP looks for the file \fI$HOME/.XWinrc\fP or, if On startup \fIXWin\fP looks for the file \fI$HOME/.XWinrc\fP or, if
the previous file does not exist, the previous file does not exist, \fI
\fI/usr/X11R6/lib/X11/system.XWinrc\fP. \fI.XWinrc\fP allows setting __sysconfdir__/X11/system.XWinrc\fP. \fI.XWinrc\fP allows setting
preferences for the following: preferences for the following:
.br .br
1- To include items into the menu associated with the \fIXWin\fP icon 1- To include items into the menu associated with the \fIXWin\fP icon
@ -102,7 +102,7 @@ respectively).
.B "\-emulate3buttons \fItimeout\fP" .B "\-emulate3buttons \fItimeout\fP"
Emulate a three button mouse; pressing both buttons within Emulate a three button mouse; pressing both buttons within
.I timeout .I timeout
milliseconds causes an emulated middle button press. The default milliseconds causes an emulated middle button press. The default
.I timeout .I timeout
is 50 milliseconds. Note that most mice with scroll wheel have middle is 50 milliseconds. Note that most mice with scroll wheel have middle
button functionality, usually you will need this option only if you have button functionality, usually you will need this option only if you have
@ -155,8 +155,8 @@ prevents the Windows mouse cursor from being placed overtop of the X
cursor. cursor.
.TP 8 .TP 8
.B "\-logfile \fIFile_Name\fP" .B "\-logfile \fIFile_Name\fP"
Change the log file from the default located at \fI/tmp/XWin.log\fP to Change the log file from the default located at \fI
the one indicated by \fIFile_Name\fP. __logdir__/XWin.0.log\fP to the one indicated by \fIFile_Name\fP.
.TP 8 .TP 8
.B "\-logverbose \fIlevel\fP" .B "\-logverbose \fIlevel\fP"
Control the degree of verbosity of the log messages with the integer Control the degree of verbosity of the log messages with the integer
@ -229,9 +229,10 @@ The \fIAlt-F4\fP key combination is enabled by default.
.TP 8 .TP 8
.B \-swcursor .B \-swcursor
Disable the usage of the windows cursor and use the X11 software cursor instead. Disable the usage of the windows cursor and use the X11 software cursor instead.
.TP 8
.B \-silent-dup-error .B \-silent-dup-error
If another instance of XWin is found running, exit silently and don't display If another instance of XWin is found running, exit silently and don't display
the error messge. the error message.
.TP 8 .TP 8
.B "\-xkblayout \fIlayout\fP" .B "\-xkblayout \fIlayout\fP"
.TP 8 .TP 8
@ -244,8 +245,8 @@ the error messge.
.B "\-xkbvariant \fIvariant\fp" .B "\-xkbvariant \fIvariant\fp"
These options implement the xkeyboard extension for loading These options implement the xkeyboard extension for loading
a particular keyboard map as the X server starts. The behavior is similar a particular keyboard map as the X server starts. The behavior is similar
to the \fIsetxkbmap\fP program. The layout data is located at to the \fIsetxkbmap\fP program. The layout data is located at \fI
\fI/usr/X11R6/lib/X11/xkb/\fP. Additional information is found in the __datadir__/X11/xkb/\fP. Additional information is found in the
README files therein and in the man page of \fIsetxkbmap\fP. For example README files therein and in the man page of \fIsetxkbmap\fP. For example
in order to load a German layout for a pc105 keyboard one uses in order to load a German layout for a pc105 keyboard one uses
the options: the options:
@ -258,7 +259,7 @@ keyboard maps.
.SH "SEE ALSO" .SH "SEE ALSO"
X(__miscmansuffix__), Xserver(1), xdm(1), xinit(1), XWinrc(1), setxkbmap(1) X(__miscmansuffix__), Xserver(1), xdm(1), xinit(1), XWinrc(__filemansuffix__), setxkbmap(1)
.SH BUGS .SH BUGS
@ -269,7 +270,7 @@ ones are:
- The display mode can not be changed once the X server has started. - The display mode can not be changed once the X server has started.
.br .br
- The XWin software is developing rapidly; it is therefore likely that - The XWin software is developing rapidly; it is therefore likely that
this man page is not up to date. It is always prudent to this man page is not up to date. It is always prudent to
look also at the output of \fIXWin -help\fP and to the Cygwin/X User Guide look also at the output of \fIXWin -help\fP and to the Cygwin/X User Guide
at /usr/share/doc/cygwin-x-doc-x.x.x/ug/cygwin-x-ug.xxx in order to at /usr/share/doc/cygwin-x-doc-x.x.x/ug/cygwin-x-ug.xxx in order to
check the options that are operative. check the options that are operative.

View File

@ -9,7 +9,8 @@ XWinrc\- XWin Server Resource Configuration File.
The X Server for the X Window System on the Cygwin/X environment The X Server for the X Window System on the Cygwin/X environment
running on Microsoft Windows, \fIXWin\fP can be optionally configured running on Microsoft Windows, \fIXWin\fP can be optionally configured
with the \fIXWinrc\fP file. A system-wide configuration file should with the \fIXWinrc\fP file. A system-wide configuration file should
be placed in \fI/usr/X11R6/lib/X11/system.XWinrc\fP, a per-user file be placed in \fI
__sysconfdir__/X11/system.XWinrc\fP, a per-user file
should be put at \fI$HOME/.XWinrc\fP. The \fIsystem.XWinrc\fP file is should be put at \fI$HOME/.XWinrc\fP. The \fIsystem.XWinrc\fP file is
read only if no \fI$HOME/.XWinrc\fP exist. read only if no \fI$HOME/.XWinrc\fP exist.
.PP .PP
@ -54,7 +55,7 @@ There are four kinds of instructions: miscellaneous, menu, icon and style.
.SH Miscellaneous instruction .SH Miscellaneous instruction
.TP 8 .TP 8
.B DEBUG \fIString\fP .B DEBUG \fIString\fP
The \fIString\fP is printed to the XWin.log file. The \fIString\fP is printed to the XWin log file.
.TP 8 .TP 8
.B TRAYICON \fIicon-specifier\fB .B TRAYICON \fIicon-specifier\fB