From f351c10a9774cc0ea2cbb58f00f07ece7f7c6e73 Mon Sep 17 00:00:00 2001 From: Yaakov Selkowitz Date: Mon, 5 Jan 2009 16:17:30 +0000 Subject: [PATCH] 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 --- hw/xwin/Makefile.am | 25 +++++++++++++++++++++--- hw/xwin/{XWin.man => XWin.man.pre} | 27 +++++++++++++------------- hw/xwin/{XWinrc.man => XWinrc.man.pre} | 5 +++-- 3 files changed, 39 insertions(+), 18 deletions(-) rename hw/xwin/{XWin.man => XWin.man.pre} (94%) rename hw/xwin/{XWinrc.man => XWinrc.man.pre} (98%) diff --git a/hw/xwin/Makefile.am b/hw/xwin/Makefile.am index 0ecb526be..aab4b08da 100644 --- a/hw/xwin/Makefile.am +++ b/hw/xwin/Makefile.am @@ -158,7 +158,7 @@ winprefsyacc.h: winprefsyacc.c winprefslex.c: winprefslex.l winprefsyacc.c winprefsyacc.h 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_LFLAGS = -i @@ -166,15 +166,34 @@ AM_CFLAGS = -DHAVE_XWIN_CONFIG_H $(DIX_CFLAGS) \ $(XWINMODULES_CFLAGS) \ -DXFree86Server -dist_man1_MANS = XWin.man XWinrc.man - GLX_EXTRAS = \ glx/glwindows.h \ glx/glwrap.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 = \ $(GLX_EXTRAS) \ + $(MAN_SRCS) \ _usr_X11R6_lib_X11_system.XWinrc \ X-boxed.ico \ X.ico \ diff --git a/hw/xwin/XWin.man b/hw/xwin/XWin.man.pre similarity index 94% rename from hw/xwin/XWin.man rename to hw/xwin/XWin.man.pre index 4e70c19f5..9649e2e60 100644 --- a/hw/xwin/XWin.man +++ b/hw/xwin/XWin.man.pre @@ -48,14 +48,14 @@ operations on the individual X windows. .SH LOG As it runs \fIXWin\fP writes messages indicating the most relevant events to the console -from which it was called and to a log file that by default is located at -\fI/tmp/XWin.log\fP. This file is mainly for debugging purposes. +from which it was called and to a log file that by default is located at \fI +__logdir__/XWin.0.log\fP. This file is mainly for debugging purposes. .SH PREFERENCES FILE On startup \fIXWin\fP looks for the file \fI$HOME/.XWinrc\fP or, if -the previous file does not exist, -\fI/usr/X11R6/lib/X11/system.XWinrc\fP. \fI.XWinrc\fP allows setting +the previous file does not exist, \fI +__sysconfdir__/X11/system.XWinrc\fP. \fI.XWinrc\fP allows setting preferences for the following: .br 1- To include items into the menu associated with the \fIXWin\fP icon @@ -102,7 +102,7 @@ respectively). .B "\-emulate3buttons \fItimeout\fP" Emulate a three button mouse; pressing both buttons within .I timeout -milliseconds causes an emulated middle button press. The default +milliseconds causes an emulated middle button press. The default .I timeout is 50 milliseconds. Note that most mice with scroll wheel have middle 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. .TP 8 .B "\-logfile \fIFile_Name\fP" -Change the log file from the default located at \fI/tmp/XWin.log\fP to -the one indicated by \fIFile_Name\fP. +Change the log file from the default located at \fI +__logdir__/XWin.0.log\fP to the one indicated by \fIFile_Name\fP. .TP 8 .B "\-logverbose \fIlevel\fP" 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 .B \-swcursor Disable the usage of the windows cursor and use the X11 software cursor instead. +.TP 8 .B \-silent-dup-error -If another instance of XWin is found running, exit silently and don't display -the error messge. +If another instance of XWin is found running, exit silently and don't display +the error message. .TP 8 .B "\-xkblayout \fIlayout\fP" .TP 8 @@ -244,8 +245,8 @@ the error messge. .B "\-xkbvariant \fIvariant\fp" These options implement the xkeyboard extension for loading a particular keyboard map as the X server starts. The behavior is similar -to the \fIsetxkbmap\fP program. The layout data is located at -\fI/usr/X11R6/lib/X11/xkb/\fP. Additional information is found in the +to the \fIsetxkbmap\fP program. The layout data is located at \fI +__datadir__/X11/xkb/\fP. Additional information is found in the 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 the options: @@ -258,7 +259,7 @@ keyboard maps. .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 @@ -269,7 +270,7 @@ ones are: - The display mode can not be changed once the X server has started. .br - 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 at /usr/share/doc/cygwin-x-doc-x.x.x/ug/cygwin-x-ug.xxx in order to check the options that are operative. diff --git a/hw/xwin/XWinrc.man b/hw/xwin/XWinrc.man.pre similarity index 98% rename from hw/xwin/XWinrc.man rename to hw/xwin/XWinrc.man.pre index 8e2498cdb..4fb436ddd 100755 --- a/hw/xwin/XWinrc.man +++ b/hw/xwin/XWinrc.man.pre @@ -9,7 +9,8 @@ XWinrc\- XWin Server Resource Configuration File. The X Server for the X Window System on the Cygwin/X environment running on Microsoft Windows, \fIXWin\fP can be optionally configured 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 read only if no \fI$HOME/.XWinrc\fP exist. .PP @@ -54,7 +55,7 @@ There are four kinds of instructions: miscellaneous, menu, icon and style. .SH Miscellaneous instruction .TP 8 .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 .B TRAYICON \fIicon-specifier\fB