From 2493d94686bfb758428c4479114f47b99db04456 Mon Sep 17 00:00:00 2001 From: Gaetan Nadon Date: Wed, 19 Jan 2011 10:06:55 -0500 Subject: config: move man pages into their own directory Use services provided by XORG_MANPAGE_SECTIONS. Use standard Makefile for man pages. Signed-off-by: Gaetan Nadon --- Makefile.am | 17 +---- configure.ac | 5 +- man/Makefile.am | 12 ++++ man/xbiff.man | 216 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ xbiff.man | 216 -------------------------------------------------------- 5 files changed, 233 insertions(+), 233 deletions(-) create mode 100644 man/Makefile.am create mode 100644 man/xbiff.man delete mode 100644 xbiff.man diff --git a/Makefile.am b/Makefile.am index 724edee..dcf3d90 100644 --- a/Makefile.am +++ b/Makefile.am @@ -19,6 +19,7 @@ # TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. +SUBDIRS = man bin_PROGRAMS = xbiff AM_CFLAGS = $(CWARNFLAGS) $(XBIFF_CFLAGS) -D_BSD_SOURCE @@ -30,25 +31,9 @@ xbiff_SOURCES = \ MailboxP.h \ xbiff.c -appman_PRE = \ - xbiff.man - EXTRA_DIST = bitmaps/mail-down bitmaps/mail-up bitmaps/mail-down-mask bitmaps/mail-up-mask -appmandir = $(APP_MAN_DIR) - -appman_DATA = $(appman_PRE:man=@APP_MAN_SUFFIX@) - -EXTRA_DIST += $(appman_PRE) MAINTAINERCLEANFILES = ChangeLog INSTALL -CLEANFILES = $(appman_DATA) - -SUFFIXES = .$(APP_MAN_SUFFIX) .man - -# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure -.man.$(APP_MAN_SUFFIX): - $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ - .PHONY: ChangeLog INSTALL diff --git a/configure.ac b/configure.ac index 609d6e7..46345f3 100644 --- a/configure.ac +++ b/configure.ac @@ -59,4 +59,7 @@ else AC_MSG_RESULT([not set]) fi -AC_OUTPUT([Makefile]) +AC_CONFIG_FILES([ + Makefile + man/Makefile]) +AC_OUTPUT diff --git a/man/Makefile.am b/man/Makefile.am new file mode 100644 index 0000000..9907070 --- /dev/null +++ b/man/Makefile.am @@ -0,0 +1,12 @@ + +appmandir = $(APP_MAN_DIR) +appman_PRE = xbiff.man +appman_DATA = $(appman_PRE:man=$(APP_MAN_SUFFIX)) + +EXTRA_DIST = $(appman_PRE) +CLEANFILES = $(appman_DATA) +SUFFIXES = .$(APP_MAN_SUFFIX) .man + +# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure +.man.$(APP_MAN_SUFFIX): + $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ diff --git a/man/xbiff.man b/man/xbiff.man new file mode 100644 index 0000000..446a47f --- /dev/null +++ b/man/xbiff.man @@ -0,0 +1,216 @@ +.\" $XConsortium: xbiff.man,v 1.22 94/04/17 20:43:28 gildea Exp $ +.\" Copyright (c) 1988 X Consortium +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining +.\" a copy of this software and associated documentation files (the +.\" "Software"), to deal in the Software without restriction, including +.\" without limitation the rights to use, copy, modify, merge, publish, +.\" distribute, sublicense, and/or sell copies of the Software, and to +.\" permit persons to whom the Software is furnished to do so, subject to +.\" the following conditions: +.\" +.\" The above copyright notice and this permission notice shall be included +.\" in all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR +.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +.\" OTHER DEALINGS IN THE SOFTWARE. +.\" +.\" Except as contained in this notice, the name of the X Consortium shall +.\" not be used in advertising or otherwise to promote the sale, use or +.\" other dealings in this Software without prior written authorization +.\" from the X Consortium. +.\" +.\" $XFree86: xc/programs/xbiff/xbiff.man,v 1.3 2001/01/27 18:21:08 dawes Exp $ +.\" +.TH XBIFF 1 __xorgversion__ +.SH NAME +xbiff \- mailbox flag for X +.SH SYNOPSIS +.B xbiff +[ \-\fItoolkitoption\fP ... ] [ \fI\-option\fP ... ] +.SH DESCRIPTION +The +.I xbiff +program displays a little image of a mailbox. When there is no mail, +the flag on the mailbox is down. When mail arrives, the flag goes up +and the mailbox beeps. By default, pressing any mouse button in the +image forces \fIxbiff\fP to remember the current size of the mail file +as being the ``empty'' size and to lower the flag. +.SH OPTIONS +.I Xbiff +accepts all of the standard X Toolkit command line options along with the +additional options listed below: +.TP 8 +.B \-help +This option indicates that a brief summary of the allowed options should be +printed on the standard error. +.TP 8 +.B \-update \fIseconds\fP +This option specifies the frequency in seconds at which \fIxbiff\fP +should update its display. If the mailbox is obscured and then exposed, +it will be updated immediately. The default is 30 seconds. +.TP 8 +.B \-file \fIfilename\fP +This option specifies the name of the file which should be monitored. By +default it watches your inbox in the default location for your +system (some examples are +.RI /var/mail/ username , +.RI /usr/spool/mail/ username , +.RI /var/spool/mail/ username +(where +.I username +is your login name). If the MAIL environment variable is set, +the file specified by it will be monitored. +.TP 8 +.B \-volume \fIpercentage\fP +This option specifies how loud the bell should be rung when new mail comes in. +.TP 8 +.B \-shape +This option indicates that the mailbox window should be shaped if masks for +the empty or full images are given. +.PP +The following standard X Toolkit command line arguments are commonly used with +.I xbiff: +.TP 8 +.B \-display \fIdisplay\fP +This option specifies the X server to contact. +.TP 8 +.B \-geometry \fIgeometry\fP +This option specifies the preferred size and position of the mailbox window. +The mailbox is 48 pixels wide and 48 pixels high and will be centered in +the window. +.TP 8 +.B \-bg \fIcolor\fP +This option specifies the color to use for the background of the window. +.TP 8 +.B \-bd \fIcolor\fP +This option specifies the color to use for the border of the window. +.TP 8 +.B \-bw \fInumber\fP +This option specifies the width in pixels of the border surrounding the window. +.TP 8 +.B \-fg \fIcolor\fP +This option specifies the color to use for the foreground of the window. +.TP 8 +.B \-rv +This option indicates that reverse video should be simulated by swapping +the foreground and background colors. +.TP 8 +.B \-xrm \fIresourcestring\fP +This option specifies a resource string to be used. This is especially +useful for setting resources that do not have separate command line options. +.SH X DEFAULTS +The application class name is XBiff. +This program uses the +.I Mailbox +widget. +It understands all of the core resource names and +classes as well as: +.PP +.TP 8 +.B checkCommand (\fPclass\fB CheckCommand) +Specifies a shell command to be executed to check for new mail rather than +examining the size of \fBfile\fP. The specified string value is used as the +argument to a \fIsystem\fP(__libmansuffix__) call and may therefore contain i/o redirection. +An exit status of 0 indicates that new mail is waiting, 1 indicates that there +has been no change in size, and 2 indicates that the mail has been cleared. +By default, no shell command is provided. +.TP 8 +.B file (\fPclass\fB File) +Specifies the name of the file to monitor. The default is as described +above for the +.B \-file +command line option. +.TP 8 +.B onceOnly (\fPclass\fB Boolean) +Specifies that the bell is only rung the first time new mail is found +and is not rung again until at least one interval has passed with +no mail waiting. The window will continue to indicate the presence +of new mail until it has been retrieved. The default is false. +.TP 8 +.B width (\fPclass\fB Width) +Specifies the width of the mailbox. +.TP 8 +.B height (\fPclass\fB Height) +Specifies the height of the mailbox. +.TP 8 +.B update (\fPclass\fB Interval) +Specifies the frequency in seconds at which the mail should be checked. +The default is 30. +.TP 8 +.B volume (\fPclass\fB Volume) +Specifies how loud the bell should be rung. The default is 33 percent. +.TP 8 +.B foreground (\fPclass\fB Foreground) +Specifies the color for the foreground. +.TP 8 +.B reverseVideo (\fPclass\fB ReverseVideo) +Specifies that the foreground and background should be reversed. +.TP 8 +.B flip (\fPclass\fB Flip) +Specifies whether or not the image that is shown when mail has arrived +should be inverted. The default is ``true.'' +.TP 8 +.B fullPixmap (\fPclass\fB Pixmap) +Specifies a bitmap to be shown when new mail has arrived. +The default is flagup. +.TP 8 +.B emptyPixmap (\fPclass\fB Pixmap) +Specifies a bitmap to be shown when no new mail is present. +The default is flagdown. +.TP 8 +.B shapeWindow (\fPclass\fB ShapeWindow) +Specifies whether or not the mailbox window should be shaped to the +given fullPixmapMask and emptyPixmapMask. The default is false. +.TP 8 +.B fullPixmapMask (\fPclass\fB PixmapMask) +Specifies a mask for the bitmap to be shown when new mail has arrived. +The default is none. +.TP 8 +.B emptyPixmapMask (\fPclass\fB PixmapMask) +Specifies a mask for the bitmap to be shown when no new mail is present. +The default is none. +.SH ACTIONS +The \fIMailbox\fP widget provides the following actions for use in event +translations: +.TP 8 +.B check() +This action causes the widget to check for new mail and display the flag +appropriately. +.TP 8 +.B unset() +This action causes the widget to lower the flag until new mail comes in. +.TP 8 +.B set() +This action causes the widget to raise the flag until the user resets it. +.PP +The default translation is +.sp +.nf + : unset() +.fi +.sp +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH "SEE ALSO" +X(__miscmansuffix__), +xrdb(__appmansuffix__), +stat(2) +.SH BUGS +The mailbox bitmaps are ugly. +.SH AUTHOR +Jim Fulton, MIT X Consortium +.br +Additional hacks by Ralph Swick, DEC/MIT Project Athena diff --git a/xbiff.man b/xbiff.man deleted file mode 100644 index 446a47f..0000000 --- a/xbiff.man +++ /dev/null @@ -1,216 +0,0 @@ -.\" $XConsortium: xbiff.man,v 1.22 94/04/17 20:43:28 gildea Exp $ -.\" Copyright (c) 1988 X Consortium -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining -.\" a copy of this software and associated documentation files (the -.\" "Software"), to deal in the Software without restriction, including -.\" without limitation the rights to use, copy, modify, merge, publish, -.\" distribute, sublicense, and/or sell copies of the Software, and to -.\" permit persons to whom the Software is furnished to do so, subject to -.\" the following conditions: -.\" -.\" The above copyright notice and this permission notice shall be included -.\" in all copies or substantial portions of the Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS -.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR -.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, -.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR -.\" OTHER DEALINGS IN THE SOFTWARE. -.\" -.\" Except as contained in this notice, the name of the X Consortium shall -.\" not be used in advertising or otherwise to promote the sale, use or -.\" other dealings in this Software without prior written authorization -.\" from the X Consortium. -.\" -.\" $XFree86: xc/programs/xbiff/xbiff.man,v 1.3 2001/01/27 18:21:08 dawes Exp $ -.\" -.TH XBIFF 1 __xorgversion__ -.SH NAME -xbiff \- mailbox flag for X -.SH SYNOPSIS -.B xbiff -[ \-\fItoolkitoption\fP ... ] [ \fI\-option\fP ... ] -.SH DESCRIPTION -The -.I xbiff -program displays a little image of a mailbox. When there is no mail, -the flag on the mailbox is down. When mail arrives, the flag goes up -and the mailbox beeps. By default, pressing any mouse button in the -image forces \fIxbiff\fP to remember the current size of the mail file -as being the ``empty'' size and to lower the flag. -.SH OPTIONS -.I Xbiff -accepts all of the standard X Toolkit command line options along with the -additional options listed below: -.TP 8 -.B \-help -This option indicates that a brief summary of the allowed options should be -printed on the standard error. -.TP 8 -.B \-update \fIseconds\fP -This option specifies the frequency in seconds at which \fIxbiff\fP -should update its display. If the mailbox is obscured and then exposed, -it will be updated immediately. The default is 30 seconds. -.TP 8 -.B \-file \fIfilename\fP -This option specifies the name of the file which should be monitored. By -default it watches your inbox in the default location for your -system (some examples are -.RI /var/mail/ username , -.RI /usr/spool/mail/ username , -.RI /var/spool/mail/ username -(where -.I username -is your login name). If the MAIL environment variable is set, -the file specified by it will be monitored. -.TP 8 -.B \-volume \fIpercentage\fP -This option specifies how loud the bell should be rung when new mail comes in. -.TP 8 -.B \-shape -This option indicates that the mailbox window should be shaped if masks for -the empty or full images are given. -.PP -The following standard X Toolkit command line arguments are commonly used with -.I xbiff: -.TP 8 -.B \-display \fIdisplay\fP -This option specifies the X server to contact. -.TP 8 -.B \-geometry \fIgeometry\fP -This option specifies the preferred size and position of the mailbox window. -The mailbox is 48 pixels wide and 48 pixels high and will be centered in -the window. -.TP 8 -.B \-bg \fIcolor\fP -This option specifies the color to use for the background of the window. -.TP 8 -.B \-bd \fIcolor\fP -This option specifies the color to use for the border of the window. -.TP 8 -.B \-bw \fInumber\fP -This option specifies the width in pixels of the border surrounding the window. -.TP 8 -.B \-fg \fIcolor\fP -This option specifies the color to use for the foreground of the window. -.TP 8 -.B \-rv -This option indicates that reverse video should be simulated by swapping -the foreground and background colors. -.TP 8 -.B \-xrm \fIresourcestring\fP -This option specifies a resource string to be used. This is especially -useful for setting resources that do not have separate command line options. -.SH X DEFAULTS -The application class name is XBiff. -This program uses the -.I Mailbox -widget. -It understands all of the core resource names and -classes as well as: -.PP -.TP 8 -.B checkCommand (\fPclass\fB CheckCommand) -Specifies a shell command to be executed to check for new mail rather than -examining the size of \fBfile\fP. The specified string value is used as the -argument to a \fIsystem\fP(__libmansuffix__) call and may therefore contain i/o redirection. -An exit status of 0 indicates that new mail is waiting, 1 indicates that there -has been no change in size, and 2 indicates that the mail has been cleared. -By default, no shell command is provided. -.TP 8 -.B file (\fPclass\fB File) -Specifies the name of the file to monitor. The default is as described -above for the -.B \-file -command line option. -.TP 8 -.B onceOnly (\fPclass\fB Boolean) -Specifies that the bell is only rung the first time new mail is found -and is not rung again until at least one interval has passed with -no mail waiting. The window will continue to indicate the presence -of new mail until it has been retrieved. The default is false. -.TP 8 -.B width (\fPclass\fB Width) -Specifies the width of the mailbox. -.TP 8 -.B height (\fPclass\fB Height) -Specifies the height of the mailbox. -.TP 8 -.B update (\fPclass\fB Interval) -Specifies the frequency in seconds at which the mail should be checked. -The default is 30. -.TP 8 -.B volume (\fPclass\fB Volume) -Specifies how loud the bell should be rung. The default is 33 percent. -.TP 8 -.B foreground (\fPclass\fB Foreground) -Specifies the color for the foreground. -.TP 8 -.B reverseVideo (\fPclass\fB ReverseVideo) -Specifies that the foreground and background should be reversed. -.TP 8 -.B flip (\fPclass\fB Flip) -Specifies whether or not the image that is shown when mail has arrived -should be inverted. The default is ``true.'' -.TP 8 -.B fullPixmap (\fPclass\fB Pixmap) -Specifies a bitmap to be shown when new mail has arrived. -The default is flagup. -.TP 8 -.B emptyPixmap (\fPclass\fB Pixmap) -Specifies a bitmap to be shown when no new mail is present. -The default is flagdown. -.TP 8 -.B shapeWindow (\fPclass\fB ShapeWindow) -Specifies whether or not the mailbox window should be shaped to the -given fullPixmapMask and emptyPixmapMask. The default is false. -.TP 8 -.B fullPixmapMask (\fPclass\fB PixmapMask) -Specifies a mask for the bitmap to be shown when new mail has arrived. -The default is none. -.TP 8 -.B emptyPixmapMask (\fPclass\fB PixmapMask) -Specifies a mask for the bitmap to be shown when no new mail is present. -The default is none. -.SH ACTIONS -The \fIMailbox\fP widget provides the following actions for use in event -translations: -.TP 8 -.B check() -This action causes the widget to check for new mail and display the flag -appropriately. -.TP 8 -.B unset() -This action causes the widget to lower the flag until new mail comes in. -.TP 8 -.B set() -This action causes the widget to raise the flag until the user resets it. -.PP -The default translation is -.sp -.nf - : unset() -.fi -.sp -.SH ENVIRONMENT -.PP -.TP 8 -.B DISPLAY -to get the default host and display number. -.TP 8 -.B XENVIRONMENT -to get the name of a resource file that overrides the global resources -stored in the RESOURCE_MANAGER property. -.SH "SEE ALSO" -X(__miscmansuffix__), -xrdb(__appmansuffix__), -stat(2) -.SH BUGS -The mailbox bitmaps are ugly. -.SH AUTHOR -Jim Fulton, MIT X Consortium -.br -Additional hacks by Ralph Swick, DEC/MIT Project Athena -- cgit v1.2.3