From 17fae9c20496a6f3e59abcc30e59d604aa809fed 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/viewres.man | 216 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ viewres.man | 216 -------------------------------------------------------- 5 files changed, 233 insertions(+), 233 deletions(-) create mode 100644 man/Makefile.am create mode 100644 man/viewres.man delete mode 100644 viewres.man diff --git a/Makefile.am b/Makefile.am index 1691e3b..ad435da 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 = viewres AM_CFLAGS = $(VIEWRES_CFLAGS) $(CWARNFLAGS) @@ -27,9 +28,6 @@ viewres_LDADD = $(VIEWRES_LIBS) viewres_SOURCES = \ viewres.c -appman_PRE = \ - viewres.man - # App default files DISTCHECK_CONFIGURE_FLAGS = --with-appdefaultdir=\$${datadir}/X11/app-defaults @@ -39,20 +37,7 @@ dist_appdefault_DATA = \ app-defaults/Viewres \ app-defaults/Viewres-color -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 bd18a72..dd3a9fd 100644 --- a/configure.ac +++ b/configure.ac @@ -45,4 +45,7 @@ AC_ARG_WITH(appdefaultdir, AC_SUBST(appdefaultdir) -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..26e63ba --- /dev/null +++ b/man/Makefile.am @@ -0,0 +1,12 @@ + +appmandir = $(APP_MAN_DIR) +appman_PRE = viewres.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/viewres.man b/man/viewres.man new file mode 100644 index 0000000..a8f0650 --- /dev/null +++ b/man/viewres.man @@ -0,0 +1,216 @@ +.\" $XConsortium: viewres.man,v 1.8 94/04/17 20:43:25 gildea Exp $ +.\" Copyright (c) 1994 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/viewres/viewres.man,v 1.3 2001/01/27 18:21:07 dawes Exp $ +.\" +.TH VIEWRES 1 __xorgversion__ +.SH NAME +viewres - graphical class browser for Xt +.SH SYNOPSIS +.B "viewres" +[-option ...] +.SH DESCRIPTION +.PP +The \fIviewres\fP program displays a tree showing the widget class hierarchy of +the Athena Widget Set. Each node in the tree can be expanded to show the +resources that the corresponding class adds (i.e. does not inherit from its +parent) when a widget is created. This application allows the user to visually +examine the structure and inherited resources for the Athena Widget Set. +.SH OPTIONS +\fIViewres\fP accepts all of the standard toolkit command line options as +well as the following: +.TP 8 +.B \-top \fIname\fP +This option specifies the name of the highest widget in the hierarchy to +display. This is typically used to limit the display to a subset of the +tree. The default is \fIObject\fP. +.TP 8 +.B \-variable +This option indicates that the widget variable names (as declared in +header files) should be displayed in the nodes rather than the widget +class name. This is sometimes useful to distinguish widget classes that +share the same name (such as \fIText\fP). +.TP 8 +.B \-vertical +This option indicates that the tree should be displayed top to bottom +rather left to right. +.SH "VIEW MENU" +The way in which the tree is displayed may be changed through the +entries in the \fBView\fP menu: +.TP 8 +.B "Show Variable Names" +This entry causes the node labels to be set to the variable names used +to declare the corresponding widget class. This operation may also be +performed with the \fBSetLabelType(variable)\fP translation. +.TP 8 +.B "Show Class Names" +This entry causes the node labels to be set to the class names used when +specifying resources. This operation may also be performed with the +\fBSetLabelType(class)\fP translation. +.TP 8 +.B "Layout Horizontal" +This entry causes the tree to be laid out from left to right. This operation +may also be performed with the \fISetOrientation(West)\fP translation. +.TP 8 +.B "Layout Vertical" +This entry causes the tree to be laid out from top to bottom. This operation +may also be performed with the \fISetOrientation(North)\fP translation. +.TP 8 +.B "Show Resource Boxes" +This entry expands the selected nodes (see next section) to show the +new widget and constraint resources. This operation +may also be performed with the \fIResources(on)\fP translation. +.TP 8 +.B "Hide Resource Boxes" +This entry removes the resource displays from the selected nodes (usually to +conserve space). This operation +may also be performed with the \fIResources(off)\fP translation. +.SH "SELECT MENU" +Resources for a single widget class can be displayed by clicking +\fBButton2\fP on the corresponding node, or by adding the node to the +selection list with \fBButton1\fP and using the \fBShow Resource Boxes\fP +entry in the \fBView\fP menu. Since \fBButton1\fP actually toggles the +selection state of a node, clicking on a selected node will cause it to be +removed from the selected list. +.PP +Collections of nodes may also be selected through the various entries in +the \fBSelect\fP menu: +.TP 8 +.B "Unselect All" +This entry removes all nodes from the selection list. This operation +may also be performed with the \fISelect(nothing)\fP translation. +.TP 8 +.B "Select All" +This entry adds all nodes to the selection list. This operation +may also be performed with the \fISelect(all)\fP translation. +.TP 8 +.B "Invert All" +This entry adds unselected nodes to, and removes selected nodes from, the +selection list. This operation +may also be performed with the \fISelect(invert)\fP translation. +.TP 8 +.B "Select Parent" +This entry selects the immediate parents of all selected nodes. This operation +may also be performed with the \fISelect(parent)\fP translation. +.TP 8 +.B "Select Ancestors" +This entry recursively selects all parents of all selected nodes. This +operation may also be performed with the \fISelect(ancestors)\fP translation. +.TP 8 +.B "Select Children" +This entry selects the immediate children of all selected nodes. This +operation may also be performed with the \fISelect(children)\fP translation. +.TP 8 +.B "Select Descendants" +This entry recursively selects all children of all selected nodes. This +operation may also be performed with the \fISelect(descendants)\fP translation. +.TP 8 +.B "Select Has Resources" +This entry selects all nodes that add new resources (regular or constraint) +to their corresponding widget classes. This operation +may also be performed with the \fISelect(resources)\fP translation. +.TP 8 +.B "Select Shown Resource Boxes" +This entry selects all nodes whose resource boxes are currently expanded +(usually so that they can be closed with \fBHide Resource Boxes\fP). This +operation may also be performed with the \fISelect(shown)\fP translation. +.SH "ACTIONS" +The following application actions are provided: +.TP 8 +.B "Quit()" +.br +This action causes \fIviewres\fP to exit. +.TP 8 +.B "SetLabelType(\fItype\fP)" +This action sets the node labels to display the widget \fIvariable\fP or +\fIclass\fP names, according to the argument \fItype\fP. +.TP 8 +.B "SetOrientation(\fIdirection\fP)" +This action sets the root of the tree to be one of the following areas of +the window: \fIWest\fP, \fINorth\fP, \fIEast\fP, or \fISouth\fP. +.TP 8 +.B "Select(\fIwhat\fP)" +This action selects the indicated nodes, as described in the \fBVIEW MENU\fP +section: \fInothing\fP (unselects all nodes), \fIinvert\fP, \fIparent\fP, +\fIancestors\fP, \fIchildren\fP, \fIdescendants\fP, \fIresources\fP, +\fIshown\fP. +.TP 8 +.B "Resources(\fIop\fP)" +This action turns \fIon\fP, \fIoff\fP, or \fItoggles\fP the resource boxes +for the selected nodes. +If invoked from within one of the nodes (through the keyboard or pointer), +only that node is used. +.SH "WIDGET HIERARCHY" +Resources may be specified for the following widgets: +.sp +.nf +.ta .5i 1.0i 1.5i 2.0i 2.5i 3.0i 3.5i 4.0i 4.5i 5.0i 5.5i 6.0i 6.5i 7.0i +Viewres viewres + Paned pane + Box buttonbox + Command quit + MenuButton view + SimpleMenu viewMenu + SmeBSB layoutHorizontal + SmeBSB layoutVertical + SmeLine line1 + SmeBSB namesVariable + SmeBSB namesClass + SmeLine line2 + SmeBSB viewResources + SmeBSB viewNoResources + MenuButton select + SimpleMenu selectMenu + SmeBSB unselect + SmeBSB selectAll + SmeBSB selectInvert + SmeLine line1 + SmeBSB selectParent + SmeBSB selectAncestors + SmeBSB selectChildren + SmeBSB selectDescendants + SmeLine line2 + SmeBSB selectHasResources + SmeBSB selectShownResources + Form treeform + Porthole porthole + Tree tree + Box \fIvariable-name\fP + Toggle \fIvariable-name\fP + List \fIvariable-name\fP + Panner panner +.fi +.sp +where \fIvariable-name\fP is the widget variable name of each node. +.SH "SEE ALSO" +X(__miscmansuffix__), xrdb(__appmansuffix__), listres(__appmansuffix__), editres(__appmansuffix__), appres(__appmansuffix__), appropriate widget documents +.SH COPYRIGHT +Copyright 1994 X Consortium +.br +See \fIX(__miscmansuffix__)\fP for a full statement of rights and permissions. +.SH AUTHOR +Jim Fulton, MIT X Consortium diff --git a/viewres.man b/viewres.man deleted file mode 100644 index a8f0650..0000000 --- a/viewres.man +++ /dev/null @@ -1,216 +0,0 @@ -.\" $XConsortium: viewres.man,v 1.8 94/04/17 20:43:25 gildea Exp $ -.\" Copyright (c) 1994 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/viewres/viewres.man,v 1.3 2001/01/27 18:21:07 dawes Exp $ -.\" -.TH VIEWRES 1 __xorgversion__ -.SH NAME -viewres - graphical class browser for Xt -.SH SYNOPSIS -.B "viewres" -[-option ...] -.SH DESCRIPTION -.PP -The \fIviewres\fP program displays a tree showing the widget class hierarchy of -the Athena Widget Set. Each node in the tree can be expanded to show the -resources that the corresponding class adds (i.e. does not inherit from its -parent) when a widget is created. This application allows the user to visually -examine the structure and inherited resources for the Athena Widget Set. -.SH OPTIONS -\fIViewres\fP accepts all of the standard toolkit command line options as -well as the following: -.TP 8 -.B \-top \fIname\fP -This option specifies the name of the highest widget in the hierarchy to -display. This is typically used to limit the display to a subset of the -tree. The default is \fIObject\fP. -.TP 8 -.B \-variable -This option indicates that the widget variable names (as declared in -header files) should be displayed in the nodes rather than the widget -class name. This is sometimes useful to distinguish widget classes that -share the same name (such as \fIText\fP). -.TP 8 -.B \-vertical -This option indicates that the tree should be displayed top to bottom -rather left to right. -.SH "VIEW MENU" -The way in which the tree is displayed may be changed through the -entries in the \fBView\fP menu: -.TP 8 -.B "Show Variable Names" -This entry causes the node labels to be set to the variable names used -to declare the corresponding widget class. This operation may also be -performed with the \fBSetLabelType(variable)\fP translation. -.TP 8 -.B "Show Class Names" -This entry causes the node labels to be set to the class names used when -specifying resources. This operation may also be performed with the -\fBSetLabelType(class)\fP translation. -.TP 8 -.B "Layout Horizontal" -This entry causes the tree to be laid out from left to right. This operation -may also be performed with the \fISetOrientation(West)\fP translation. -.TP 8 -.B "Layout Vertical" -This entry causes the tree to be laid out from top to bottom. This operation -may also be performed with the \fISetOrientation(North)\fP translation. -.TP 8 -.B "Show Resource Boxes" -This entry expands the selected nodes (see next section) to show the -new widget and constraint resources. This operation -may also be performed with the \fIResources(on)\fP translation. -.TP 8 -.B "Hide Resource Boxes" -This entry removes the resource displays from the selected nodes (usually to -conserve space). This operation -may also be performed with the \fIResources(off)\fP translation. -.SH "SELECT MENU" -Resources for a single widget class can be displayed by clicking -\fBButton2\fP on the corresponding node, or by adding the node to the -selection list with \fBButton1\fP and using the \fBShow Resource Boxes\fP -entry in the \fBView\fP menu. Since \fBButton1\fP actually toggles the -selection state of a node, clicking on a selected node will cause it to be -removed from the selected list. -.PP -Collections of nodes may also be selected through the various entries in -the \fBSelect\fP menu: -.TP 8 -.B "Unselect All" -This entry removes all nodes from the selection list. This operation -may also be performed with the \fISelect(nothing)\fP translation. -.TP 8 -.B "Select All" -This entry adds all nodes to the selection list. This operation -may also be performed with the \fISelect(all)\fP translation. -.TP 8 -.B "Invert All" -This entry adds unselected nodes to, and removes selected nodes from, the -selection list. This operation -may also be performed with the \fISelect(invert)\fP translation. -.TP 8 -.B "Select Parent" -This entry selects the immediate parents of all selected nodes. This operation -may also be performed with the \fISelect(parent)\fP translation. -.TP 8 -.B "Select Ancestors" -This entry recursively selects all parents of all selected nodes. This -operation may also be performed with the \fISelect(ancestors)\fP translation. -.TP 8 -.B "Select Children" -This entry selects the immediate children of all selected nodes. This -operation may also be performed with the \fISelect(children)\fP translation. -.TP 8 -.B "Select Descendants" -This entry recursively selects all children of all selected nodes. This -operation may also be performed with the \fISelect(descendants)\fP translation. -.TP 8 -.B "Select Has Resources" -This entry selects all nodes that add new resources (regular or constraint) -to their corresponding widget classes. This operation -may also be performed with the \fISelect(resources)\fP translation. -.TP 8 -.B "Select Shown Resource Boxes" -This entry selects all nodes whose resource boxes are currently expanded -(usually so that they can be closed with \fBHide Resource Boxes\fP). This -operation may also be performed with the \fISelect(shown)\fP translation. -.SH "ACTIONS" -The following application actions are provided: -.TP 8 -.B "Quit()" -.br -This action causes \fIviewres\fP to exit. -.TP 8 -.B "SetLabelType(\fItype\fP)" -This action sets the node labels to display the widget \fIvariable\fP or -\fIclass\fP names, according to the argument \fItype\fP. -.TP 8 -.B "SetOrientation(\fIdirection\fP)" -This action sets the root of the tree to be one of the following areas of -the window: \fIWest\fP, \fINorth\fP, \fIEast\fP, or \fISouth\fP. -.TP 8 -.B "Select(\fIwhat\fP)" -This action selects the indicated nodes, as described in the \fBVIEW MENU\fP -section: \fInothing\fP (unselects all nodes), \fIinvert\fP, \fIparent\fP, -\fIancestors\fP, \fIchildren\fP, \fIdescendants\fP, \fIresources\fP, -\fIshown\fP. -.TP 8 -.B "Resources(\fIop\fP)" -This action turns \fIon\fP, \fIoff\fP, or \fItoggles\fP the resource boxes -for the selected nodes. -If invoked from within one of the nodes (through the keyboard or pointer), -only that node is used. -.SH "WIDGET HIERARCHY" -Resources may be specified for the following widgets: -.sp -.nf -.ta .5i 1.0i 1.5i 2.0i 2.5i 3.0i 3.5i 4.0i 4.5i 5.0i 5.5i 6.0i 6.5i 7.0i -Viewres viewres - Paned pane - Box buttonbox - Command quit - MenuButton view - SimpleMenu viewMenu - SmeBSB layoutHorizontal - SmeBSB layoutVertical - SmeLine line1 - SmeBSB namesVariable - SmeBSB namesClass - SmeLine line2 - SmeBSB viewResources - SmeBSB viewNoResources - MenuButton select - SimpleMenu selectMenu - SmeBSB unselect - SmeBSB selectAll - SmeBSB selectInvert - SmeLine line1 - SmeBSB selectParent - SmeBSB selectAncestors - SmeBSB selectChildren - SmeBSB selectDescendants - SmeLine line2 - SmeBSB selectHasResources - SmeBSB selectShownResources - Form treeform - Porthole porthole - Tree tree - Box \fIvariable-name\fP - Toggle \fIvariable-name\fP - List \fIvariable-name\fP - Panner panner -.fi -.sp -where \fIvariable-name\fP is the widget variable name of each node. -.SH "SEE ALSO" -X(__miscmansuffix__), xrdb(__appmansuffix__), listres(__appmansuffix__), editres(__appmansuffix__), appres(__appmansuffix__), appropriate widget documents -.SH COPYRIGHT -Copyright 1994 X Consortium -.br -See \fIX(__miscmansuffix__)\fP for a full statement of rights and permissions. -.SH AUTHOR -Jim Fulton, MIT X Consortium -- cgit v1.2.3