Package: twm
Version: 1:1.0.10-1+b1
Severity: minor
Tags: patch
* What led up to the situation?
Checking for defects with a new version
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z < "man
page"
[Use "grep -e ' $' -e '\\~$' <file>" to find obvious trailing spaces.]
["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).
[The fate of "test-nroff" was decided in groff bug #55941.]
* What was the outcome of this action?
troff:<stdin>:377: warning: trailing space in the line
troff:<stdin>:646: warning: trailing space in the line
troff:<stdin>:731: warning: trailing space in the line
troff:<stdin>:761: warning: trailing space in the line
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.12.19-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages twm depends on:
ii libc6 2.41-6
ii libice6 2:1.1.1-1
ii libsm6 2:1.2.4-1
ii libx11-6 2:1.8.10-2
ii libxext6 2:1.3.4-1+b3
ii libxmu6 2:1.1.3-3+b4
ii libxt6t64 1:1.2.1-1.2+b2
ii menu 2.1.51
twm recommends no packages.
twm suggests no packages.
-- no debconf information
Input file is twm.1
Output from "mandoc -T lint twm.1": (shortened list)
1 input text line longer than 80 bytes: and may only be give...
1 input text line longer than 80 bytes: may only be specifie...
1 input text line longer than 80 bytes: only be specified in...
6 skipping paragraph macro: PP after SH
1 skipping paragraph macro: PP empty
-.-.
Output from "test-nroff -mandoc -t -ww -z twm.1": (shortened list)
4 line(s) with a trailing space
Remove trailing space with: sed -e 's/ *$//'
-.-.
Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-),
if it
is in front of a name for an option,
is a symbol for standard input,
is a single character used to indicate an option,
or is in the NAME section (man-pages(7)).
N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen
(0x2010, groff \[u2010] or \[hy]) in the output.
84:information requested by the user (usually through \fI-geometry\fP
553:screen width. The default height is 32767 - screen height.
747:convenience, the ratio 0/0 is the same as 1/2 for \fBcenter\fP and -1/1
765:programs that do not support an \fI-iconic\fP command line option or
875:keysym name; buttons are given as the keywords \fBButton1\fP-\fBButton5\fP:
1221:all of the client and \fItwm\fP-supplied windows. Selecting an entry will
-.-.
Find a repeated word
! 410 --> if
! 826 --> of
! 1239 --> the
-.-.
Add a "\&" (or a comma (Oxford comma)) after an abbreviation
or use English words
(man-pages(7)).
Abbreviation points should be marked as such and protected against being
interpreted as an end of sentence, if they are not, and that independent
of the current place on the line.
126:The \fIscreennumber\fP is a small positive number (e.g. 0, 1, etc.)
127:representing the screen number (e.g. the last number in the DISPLAY
environment
160:by double quote characters (e.g. "blue") and are case-sensitive.
186:(e.g. to determine whether or not to enable autoraise as shown above), a
string
686:unquoted, signed number (e.g. 999). This variable has an effect only
1087:integer in double quotes (e.g. "999" ). This function has an effect only
1169:specified by the argument \fIstring\fP. If \fIstring\fP is empty (i.e.
""),
1173:argument \fIstring\fP. \fIString\fP may be a number (e.g. \fB"0"\fP or
-.-.
Wrong distance (not two spaces) between sentences in the input file.
Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").
The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.
Remember coding: Only one command ("sentence") on each (logical) line.
E-mail: Easier to quote exactly the relevant lines.
Generally: Easier to edit the sentence.
Patches: Less unaffected text.
Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.
The amount of space between sentences in the output can then be
controlled with the ".ss" request.
Mark a final abbreviation point as such by suffixing it with "\&".
Some sentences (etc.) do not begin on a new line.
Split (sometimes) lines after a punctuation mark; before a conjunction.
Lines with only one (or two) space(s) between sentences could be split,
so latter sentences begin on a new line.
Use
#!/usr/bin/sh
sed -e '/^\./n' \
-e 's/\([[:alpha:]]\)\. */\1.\n/g' $1
to split lines after a sentence period.
Check result with the difference between the formatted outputs.
See also the attachment "general.bugs"
126:The \fIscreennumber\fP is a small positive number (e.g. 0, 1, etc.)
127:representing the screen number (e.g. the last number in the DISPLAY
environment
160:by double quote characters (e.g. "blue") and are case-sensitive.
186:(e.g. to determine whether or not to enable autoraise as shown above), a
string
686:unquoted, signed number (e.g. 999). This variable has an effect only
1087:integer in double quotes (e.g. "999" ). This function has an effect only
1169:specified by the argument \fIstring\fP. If \fIstring\fP is empty (i.e.
""),
1173:argument \fIstring\fP. \fIString\fP may be a number (e.g. \fB"0"\fP or
-.-.
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
Add "\:" to split the string for the output, "\<newline>" in the source.
Line 249, length 90
and may only be given within a \fBColor\fP, \fBGrayscale\fP or \fBMonochrome\fP
list. The
Line 256, length 94
\fBColor\fP, \fBGrayscale\fP or \fBMonochrome\fP list. The optional
\fIwincolorlist\fP allows
Line 393, length 84
only be specified inside of a \fBColor\fP, \fBGrayscale\fP or \fBMonochrome\fP
list.
Line 400, length 88
may only be specified inside of a \fBColor\fP, \fBGrayscale\fP or
\fBMonochrome\fP list.
Line 739, length 83
"\fIname\fP" \fIjustification\fP \fInum\fP
\fIdenom\fP
Longest line is number 256 with 94 characters
-.-.
Use \(en (en-dash) for a dash at the beginning (end) of a line,
or between space characters,
not a minus (\-) or a hyphen (-), except in the NAME section.
twm.1:552:restrict windows to the size of the screen. The default width is
32767 -
twm.1:553:screen width. The default height is 32767 - screen height.
-.-.
The name of a man page is typeset in bold and the section in roman
(see man-pages(7)).
54:startup script. When used from \fIxdm(1)\fP or \fIxinit(1)\fP without
145:Widgets\fP manual and \fIxrdb(1)\fP).
340:the glyph image and mask in \fIbitmap(1)\fP form.
1277:X(7), Xserver(1), xdm(1), xrdb(1)
-.-.
Add a zero (0) in front of a decimal fraction that begins with a period
(.)
30:.if t .sp .5
38:.if t .sp .5
-.-.
Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".
[List of affected lines removed.]
-.-
Only one space character is after a possible end of sentence
(after a punctuation, that can end a sentence).
twm.1:126:The \fIscreennumber\fP is a small positive number (e.g. 0, 1, etc.)
twm.1:127:representing the screen number (e.g. the last number in the DISPLAY
environment
twm.1:160:by double quote characters (e.g. "blue") and are case-sensitive.
twm.1:186:(e.g. to determine whether or not to enable autoraise as shown
above), a string
twm.1:686:unquoted, signed number (e.g. 999). This variable has an effect only
twm.1:1087:integer in double quotes (e.g. "999" ). This function has an effect
only
twm.1:1169:specified by the argument \fIstring\fP. If \fIstring\fP is empty
(i.e. ""),
twm.1:1173:argument \fIstring\fP. \fIString\fP may be a number (e.g. \fB"0"\fP
or
-.-.
Put a subordinate sentence (after a comma) on a new line.
[List of affected lines removed.]
-.-.
Remove quotes when there is a printable
but no space character between them
and the quotes are not for emphasis (markup),
for example as an argument to a macro.
twm.1:125:.B "$HOME/.twmrc.\fIscreennumber\fP"
twm.1:132:.B "$HOME/.twmrc"
twm.1:216:.IP "\fBAutoRelativeResize\fP" 8
twm.1:269:.IP "\fBClientBorderWidth\fP" 8
twm.1:359:.IP "\fBDecorateTransients\fP" 8
twm.1:374:.IP "\fBDontMoveOff\fP" 8
twm.1:382:.IP "\fBForceIcons\fP" 8
twm.1:527:.IP "\fBInterpolateMenuColors\fP" 8
twm.1:593:.IP "\fBNoBackingStore\fP" 8
twm.1:597:.IP "\fBNoCaseSensitive\fP" 8
twm.1:601:.IP "\fBNoDefaults\fP" 8
twm.1:605:.IP "\fBNoGrabServer\fP" 8
twm.1:616:.IP "\fBNoIconManagers\fP" 8
twm.1:618:.IP "\fBNoMenuShadows\fP" 8
twm.1:622:.IP "\fBNoRaiseOnDeiconify\fP" 8
twm.1:625:.IP "\fBNoRaiseOnMove\fP" 8
twm.1:628:.IP "\fBNoRaiseOnResize\fP" 8
twm.1:631:.IP "\fBNoRaiseOnWarp\fP" 8
twm.1:637:.IP "\fBNoSaveUnders\fP" 8
twm.1:651:.IP "\fBNoTitleFocus\fP" 8
twm.1:667:.IP "\fBOpaqueMove\fP" 8
twm.1:688:.IP "\fBRandomPlacement\fP" 8
twm.1:695:.IP "\fBRestartPreviousState\fP" 8
twm.1:723:.IP "\fBShowIconManager\fP" 8
twm.1:727:.IP "\fBSortIconManager\fP" 8
twm.1:817:.IP "\fBWarpUnmapped\fP" 8
twm.1:954:.IP "\fBf.autoraise\fP" 8
twm.1:957:.IP "\fBf.backiconmgr\fI" 8
twm.1:960:.IP "\fBf.beep\fP" 8
twm.1:962:.IP "\fBf.bottomzoom\fP" 8
twm.1:965:.IP "\fBf.circledown\fP" 8
twm.1:967:.IP "\fBf.circleup\fP" 8
twm.1:986:.IP "\fBf.deiconify\fP" 8
twm.1:989:.IP "\fBf.delete\fP" 8
twm.1:998:.IP "\fBf.deltastop\fP" 8
twm.1:1002:.IP "\fBf.destroy\fP" 8
twm.1:1006:.IP "\fBf.downiconmgr\fI" 8
twm.1:1017:.IP "\fBf.focus\fP" 8
twm.1:1022:.IP "\fBf.forcemove\fP" 8
twm.1:1025:.IP "\fBf.forwiconmgr\fI" 8
twm.1:1028:.IP "\fBf.fullzoom\fP" 8
twm.1:1034:.IP "\fBf.hbzoom\fP" 8
twm.1:1036:.IP "\fBf.hideiconmgr\fP" 8
twm.1:1038:.IP "\fBf.horizoom\fP" 8
twm.1:1041:.IP "\fBf.htzoom\fP" 8
twm.1:1043:.IP "\fBf.hzoom\fP" 8
twm.1:1045:.IP "\fBf.iconify\fP" 8
twm.1:1048:.IP "\fBf.identify\fP" 8
twm.1:1054:.IP "\fBf.lefticonmgr\fI" 8
twm.1:1057:.IP "\fBf.leftzoom\fP" 8
twm.1:1060:.IP "\fBf.lower\fP" 8
twm.1:1065:.IP "\fBf.move\fP" 8
twm.1:1075:.IP "\fBf.nexticonmgr\fI" 8
twm.1:1078:.IP "\fBf.nop\fP" 8
twm.1:1081:.IP "\fBf.previconmgr\fI" 8
twm.1:1089:.IP "\fBf.quit\fP" 8
twm.1:1093:.IP "\fBf.raise\fP" 8
twm.1:1095:.IP "\fBf.raiselower\fP" 8
twm.1:1098:.IP "\fBf.refresh\fP" 8
twm.1:1100:.IP "\fBf.resize\fP" 8
twm.1:1105:.IP "\fBf.restart\fP" 8
twm.1:1110:.IP "\fBf.righticonmgr\fI" 8
twm.1:1113:.IP "\fBf.rightzoom\fP" 8
twm.1:1116:.IP "\fBf.saveyourself\fP" 8
twm.1:1123:.IP "\fBf.showiconmgr\fP" 8
twm.1:1125:.IP "\fBf.sorticonmgr\fP" 8
twm.1:1134:.IP "\fBf.title\fP" 8
twm.1:1137:.IP "\fBf.topzoom\fP" 8
twm.1:1144:.IP "\fBf.unfocus\fP" 8
twm.1:1147:.IP "\fBf.upiconmgr\fI" 8
twm.1:1154:.IP "\fBf.vlzoom\fP" 8
twm.1:1156:.IP "\fBf.vrzoom\fP" 8
twm.1:1179:.IP "\fBf.winrefresh\fP" 8
twm.1:1182:.IP "\fBf.zoom\fP" 8
twm.1:1269:.IP "DISPLAY" 8
twm.1:1272:.IP "HOME" 8
-.-.
Section headings (.SH and .SS) do not need quoting their arguments.
1268:.SH "ENVIRONMENT VARIABLES"
1275:.SH "SEE ALSO"
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
troff:<stdin>:377: warning: trailing space in the line
troff:<stdin>:646: warning: trailing space in the line
troff:<stdin>:731: warning: trailing space in the line
troff:<stdin>:761: warning: trailing space in the line
-.-.
Generally:
Split (sometimes) lines after a punctuation mark; before a conjunction.
--- twm.1 2025-03-29 14:18:05.443744572 +0000
+++ twm.1.new 2025-03-29 15:44:42.231882480 +0000
@@ -1,3 +1,4 @@
+'\" t
.\" Copyright 1993, 1994, 1998 The Open Group
.\" Portions copyright 1988 Evans & Sutherland Computer Corporation.
.\" Portions copyright 1989 Hewlett-Packard Company
@@ -27,15 +28,15 @@
.de EX \"Begin example
.ne 5
.if n .sp 1
-.if t .sp .5
+.if t .sp 0.5
.nf
-.in +.5i
+.in +0.5i
..
.de EE
.fi
-.in -.5i
+.in -0.5i
.if n .sp 1
-.if t .sp .5
+.if t .sp 0.5
..
.TH TWM 1 "twm 1.0.10" "X Version 11"
.SH NAME
@@ -51,7 +52,7 @@ click-to-type and pointer-driven keyboar
key and pointer button bindings.
.PP
This program is usually started by the user's session manager or
-startup script. When used from \fIxdm(1)\fP or \fIxinit(1)\fP without
+startup script. When used from \fBxdm\fP(1) or \fBxinit\fP(1) without
a session manager, \fItwm\fP is frequently executed in the foreground
as the last client. When run this way, exiting \fItwm\fP causes the
session to be terminated (i.e., logged out).
@@ -81,7 +82,7 @@ when the outline is in the desired posit
clicking in the title or highlight region raises the window without moving it.
.PP
When new windows are created, \fItwm\fP will honor any size and location
-information requested by the user (usually through \fI-geometry\fP
+information requested by the user (usually through \fI\-geometry\fP
command line argument or resources for the individual applications).
Otherwise, an outline of the window's default size, its titlebar, and lines
dividing the
@@ -96,7 +97,6 @@ will give the window its current positio
to touch the bottom the screen.
.SH OPTIONS
\fITwm\fP accepts the following command line options:
-.PP
.TP 8
.B \-display \fIdpy\fP
This option specifies the X server to use.
@@ -117,15 +117,16 @@ This option indicates that \fItwm\fP sho
an unexpected X Error event is received. This can be useful when debugging
applications but can be distracting in regular use.
.SH CUSTOMIZATION
-.PP
Much of \fItwm\fP's appearance and behavior can be controlled by providing
a startup file in one of the following locations (searched in order for
each screen being managed when \fItwm\fP begins):
.TP 8
.B "$HOME/.twmrc.\fIscreennumber\fP"
-The \fIscreennumber\fP is a small positive number (e.g. 0, 1, etc.)
-representing the screen number (e.g. the last number in the DISPLAY environment
-variable \fIhost:displaynum.screennum\fP) that would be used to contact that
+The \fIscreennumber\fP is a small positive number (e.g.\& 0, 1, etc.\&)
+representing the screen number
+(e.g.\& the last number in the DISPLAY environment
+variable \fIhost:displaynum.screennum\fP)
+that would be used to contact that
screen of the display. This is intended for displays with multiple screens of
differing visual types.
.TP 8
@@ -142,7 +143,7 @@ If no startup files are found, \fItwm\fP
described above. The only resource used by \fItwm\fP is
\fIbitmapFilePath\fP for a colon-separated list of directories to search
when looking for bitmap files (for more information, see the \fIAthena
-Widgets\fP manual and \fIxrdb(1)\fP).
+Widgets\fP manual and \fBxrdb\fP(1)).
.PP
\fITwm\fP startup files are logically broken up into three types of
specifications: \fIVariables\fP, \fIBindings\fP, \fIMenus\fP. The
@@ -157,12 +158,11 @@ user-defined menus (containing functions
commands to be executed).
.PP
Variable names and keywords are case-insensitive. Strings must be surrounded
-by double quote characters (e.g. "blue") and are case-sensitive.
+by double quote characters (e.g.\& "blue") and are case-sensitive.
A pound sign (#) outside
of a string causes the remainder of the line in which the character appears to
be treated as a comment.
.SH VARIABLES
-.PP
Many of the aspects of \fItwm\fP's user interface are controlled by variables
that may be set in the user's startup file. Some of the options are
enabled or disabled simply by the presence of a particular keyword. Other
@@ -183,7 +183,8 @@ or
}
.EE
When a variable containing a list of strings representing windows is searched
-(e.g. to determine whether or not to enable autoraise as shown above), a string
+(e.g.\& to determine
+whether or not to enable autoraise as shown above), a string
must be an exact, case-sensitive match to
the window's name (given by the WM_NAME window property), resource name
or class name (both given by the WM_CLASS window property). The preceding
@@ -246,8 +247,10 @@ The default is "black".
.IP "\fBBorderTileBackground\fP \fIstring\fP [{ \fIwincolorlist\fP }]" 8
This variable specifies the default background color in the gray pattern
used in unhighlighted borders (only if \fBNoHighlight\fP hasn't been set),
-and may only be given within a \fBColor\fP, \fBGrayscale\fP or
\fBMonochrome\fP list. The
-optional \fIwincolorlist\fP allows per-window colors to be specified.
+and may only be given within a \fBColor\fP,
+\fBGrayscale\fP
+or \fBMonochrome\fP list.
+The optional \fIwincolorlist\fP allows per-window colors to be specified.
The default is "white".
.IP "\fBBorderTileForeground\fP \fIstring\fP [{ \fIwincolorlist\fP }]" 8
This variable specifies the default foreground color in the gray pattern
@@ -302,11 +305,16 @@ For example:
.EX 0
\fBColor\fP
{
- MenuBackground "gray50"
- MenuForeground "blue"
- BorderColor "red" { "XTerm" "yellow" }
- TitleForeground "yellow"
- TitleBackground "blue"
+.in +8n
+.TS
+l l .
+MenuBackground "gray50"
+MenuForeground "blue"
+BorderColor "red" { "XTerm" "yellow" }
+TitleForeground "yellow"
+TitleBackground "blue"
+.TE
+.in -8n
}
.EE
All of these color variables may also be specified for the \fBMonochrome\fP
@@ -337,23 +345,28 @@ from bitmap files, the following syntax
\fIcursorname\fP "\fIimage\fP" "\fImask\fP"
.EE
The \fIimage\fP and \fImask\fP strings specify the names of files containing
-the glyph image and mask in \fIbitmap(1)\fP form.
+the glyph image and mask in \fBbitmap\fP(1) form.
The bitmap files are located in the same manner as icon bitmap files.
The following example shows the default cursor definitions:
.EX 0
\fBCursors\fP
{
- Frame "top_left_arrow"
- Title "top_left_arrow"
- Icon "top_left_arrow"
- IconMgr "top_left_arrow"
- Move "fleur"
- Resize "fleur"
- Menu "sb_left_arrow"
- Button "hand2"
- Wait "watch"
- Select "dot"
- Destroy "pirate"
+.in +8n
+.TS
+l l .
+Frame "top_left_arrow"
+Title "top_left_arrow"
+Icon "top_left_arrow"
+IconMgr "top_left_arrow"
+Move "fleur"
+Resize "fleur"
+Menu "sb_left_arrow"
+Button "hand2"
+Wait "watch"
+Select "dot"
+Destroy "pirate"
+.TE
+.in -8n
}
.EE
.IP "\fBDecorateTransients\fP" 8
@@ -374,7 +387,7 @@ as icons while other windows are handled
.IP "\fBDontMoveOff\fP" 8
This variable indicates that windows should not be allowed to be moved off the
screen. It can be overridden by the \fBf.forcemove\fP function.
-.IP "\fBDontSqueezeTitle\fP [{ \fIwin-list\fP }] " 8
+.IP "\fBDontSqueezeTitle\fP [{ \fIwin-list\fP }]" 8
This variable indicates that titlebars should not be squeezed to their
minimum size as described under \fBSqueezeTitle\fP below.
If the optional window list is supplied, only those windows will be
@@ -390,14 +403,18 @@ This variable specifies a list of color
the screen has a GrayScale default visual. See the description of
\fBColors\fP.
.IP "\fBIconBackground\fP \fIstring\fP [{ \fIwin-list\fP }]" 8
This variable specifies the background color of icons, and may
-only be specified inside of a \fBColor\fP, \fBGrayscale\fP or \fBMonochrome\fP
list.
+only be specified inside of a \fBColor\fP,
+\fBGrayscale\fP
+or \fBMonochrome\fP list.
The optional \fIwin-list\fP is a list of window names and colors so that
per-window colors may be specified. See the \fBBorderColor\fP
variable for a complete description of the \fIwin-list\fP.
The default is "white".
.IP "\fBIconBorderColor\fP \fIstring\fP [{ \fIwin-list\fP }]" 8
This variable specifies the color of the border used for icon windows, and
-may only be specified inside of a \fBColor\fP, \fBGrayscale\fP or
\fBMonochrome\fP list.
+may only be specified inside of a \fBColor\fP,
+\fBGrayscale\fP
+or \fBMonochrome\fP list.
The optional \fIwin-list\fP is a list of window names and colors so that
per-window colors may be specified. See the \fBBorderColor\fP
variable for a complete description of the \fIwin-list\fP.
@@ -406,7 +423,7 @@ The default is "black".
This variable specifies the width in pixels of the border surrounding
icon windows. The default is 2.
.IP "\fBIconDirectory\fP \fIstring\fP" 8
-This variable specifies the directory that should be searched if
+This variable specifies the directory that should be searched
if a bitmap file cannot be found in any of the directories
in the \fBbitmapFilePath\fP resource.
.IP "\fBIconFont\fP \fIstring\fP" 8
@@ -484,8 +501,8 @@ the number of columns in this icon manag
.EX 0
\fBIconManagers\fP
{
- "XTerm" "=300x5+800+5" 5
- "myhost" "=400x5+100+5" 2
+ "XTerm" "=300x5+800+5" 5
+ "myhost" "=400x5+100+5" 2
}
.EE
Clients whose name or class is ``XTerm'' will have an entry created
@@ -516,7 +533,7 @@ should be used as their icons. For exam
\fBIcons\fP
{
"XTerm" "xterm.icon"
- "xfd" "xfd_icon"
+ "xfd" "xfd_icon"
}
.EE
Windows that match ``XTerm'' and would not be iconified by unmapping, and
@@ -530,12 +547,17 @@ entry specified colors. In the example
.EX 0
\fBMenu\fP "mymenu"
{
- "Title" ("black":"red") f.title
- "entry1" f.nop
- "entry2" f.nop
- "entry3" ("white":"green") f.nop
- "entry4" f.nop
- "entry5" ("red":"white") f.nop
+.in +8n
+.TS
+l l l .
+"Title" ("black":"red") f.title
+"entry1" \& f.nop
+"entry2" \& f.nop
+"entry3" ("white":"green") f.nop
+"entry4" \& f.nop
+"entry5" ("red":"white") f.nop
+.TE
+.in -8n
}
.EE
the foreground colors for ``entry1'' and ``entry2'' will be interpolated
@@ -549,8 +571,8 @@ set.
.IP "\fBMaxWindowSize\fP \fIstring\fP" 8
This variable specifies a geometry in which the width and height
give the maximum size for a given window. This is typically used to
-restrict windows to the size of the screen. The default width is 32767 -
-screen width. The default height is 32767 - screen height.
+restrict windows to the size of the screen. The default width is 32767 \-
+screen width. The default height is 32767 \- screen height.
.IP "\fBMenuBackground\fP \fIstring\fP" 8
This variable specifies the background color used for menus,
and can only be specified inside of a
@@ -643,7 +665,7 @@ This variable indicates that client wind
should be ignored. If the optional \fIwin-list\fP is given, only requests on
those windows will be ignored. This is typically used to prevent applications
from relentlessly popping themselves to the front of the window stack.
-.IP "\fBNoTitle\fP [{ \fIwin-list\fP }] " 8
+.IP "\fBNoTitle\fP [{ \fIwin-list\fP }]" 8
This variable indicates that windows should not have titlebars. If the
optional \fIwin-list\fP is given, only those windows will not have titlebars.
\fBMakeTitle\fP may be used with this option to force titlebars to be put
@@ -683,7 +705,7 @@ may be specified:
The default for \fITitleHighlight\fP is to use an even stipple pattern.
.IP "\fBPriority\fP \fIpriority\fP" 8
This variable sets \fItwm\fP's priority. \fIpriority\fP should be an
-unquoted, signed number (e.g. 999). This variable has an effect only
+unquoted, signed number (e.g.\& 999). This variable has an effect only
if the server supports the SYNC extension.
.IP "\fBRandomPlacement\fP" 8
This variable indicates that windows with no specified geometry should
@@ -728,7 +750,7 @@ This variable indicates that the icon ma
This variable indicates that entries in the icon manager should be
sorted alphabetically rather than by simply appending new windows to
the end.
-.IP "\fBSqueezeTitle\fP [{ \fIsqueeze-list\fP }] " 8
+.IP "\fBSqueezeTitle\fP [{ \fIsqueeze-list\fP }]" 8
This variable indicates that \fItwm\fP should attempt to use the SHAPE
extension to make titlebars occupy only as much screen space as they need,
rather than extending all the way across the top of the window.
@@ -744,25 +766,30 @@ are numbers specifying a ratio giving th
the titlebar is justified. The ratio is measured from left to right if
the numerator is positive, and right to left if negative. A denominator
of 0 indicates that the numerator should be measured in pixels. For
-convenience, the ratio 0/0 is the same as 1/2 for \fBcenter\fP and -1/1
+convenience, the ratio 0/0 is the same as 1/2 for \fBcenter\fP and \-1/1
for \fBright\fP. For example:
.EX 0
\fBSqueezeTitle\fP
{
- "XTerm" left 0 0
- "xterm1" left 1 3
- "xterm2" left 2 3
- "oclock" center 0 0
- "emacs" right 0 0
+.in +8n
+.TS
+l l l l .
+"XTerm" left 0 0
+"xterm1" left 1 3
+"xterm2" left 2 3
+"oclock" center 0 0
+"emacs" right 0 0
+.TE
+.in -8n
}
.EE
The \fBDontSqueezeTitle\fP list can be used to turn off squeezing on
certain titles.
-.IP "\fBStartIconified\fP [{ \fIwin-list\fP }] " 8
+.IP "\fBStartIconified\fP [{ \fIwin-list\fP }]" 8
This variable indicates that client windows should initially be left as
icons until explicitly deiconified by the user. If the optional \fIwin-list\fP
is given, only those windows will be started iconic. This is useful for
-programs that do not support an \fI-iconic\fP command line option or
+programs that do not support an \fI\-iconic\fP command line option or
resource.
.IP "\fBTitleBackground\fP \fIstring\fP [{ \fIwin-list\fP }]" 8
This variable specifies the background color used in titlebars,
@@ -822,7 +849,7 @@ where it is. The default is for \fBf.wa
.IP "\fBXorValue\fP \fInumber\fP" 8
This variable specifies the value to use when drawing window outlines for
moving and resizing. This should be set to a value that will result in a
-variety of
+variety
of distinguishable colors when exclusive-or'ed with the contents of the
user's typical screen. Setting this variable to 1 often gives nice results
if adjacent colors in the default colormap are distinct. By default,
@@ -846,7 +873,6 @@ This variable specifies the function to
from the \fBTwmWindows\fP menu. If this variable is not set, the window
will be deiconified and raised.
.SH BINDINGS
-.PP
After the desired variables have been set, functions may be attached
titlebuttons and key and pointer buttons. Titlebuttons may be added
from the left or right side and appear in the titlebar from left-to-right
@@ -872,7 +898,7 @@ Key and pointer button specifications mu
be pressed, over which parts of the screen the pointer must be, and what
function is to be invoked. Keys are given as strings containing the
appropriate
-keysym name; buttons are given as the keywords \fBButton1\fP-\fBButton5\fP:
+keysym name; buttons are given as the keywords \fBButton1\fP\-\fBButton5\fP:
.EX 0
"FP1" = \fImodlist\fP : \fIcontext\fP : \fIfunction\fP
\fBButton1\fP = \fImodlist\fP : \fIcontext\fP : \fIfunction\fP
@@ -1084,7 +1110,7 @@ windows on the current or preceding scre
.IP "\fBf.priority\fP \fIstring\fP" 8
This function sets the priority of the client owning the selected window to
the numeric value of the argument \fIstring\fP, which should be a signed
-integer in double quotes (e.g. "999" ). This function has an effect only
+integer in double quotes (e.g.\& "999" ). This function has an effect only
if the server supports the SYNC extension.
.IP "\fBf.quit\fP" 8
This function causes \fItwm\fP to restore the window's borders and exit. If
@@ -1166,11 +1192,11 @@ if the variable \fBWarpUnmapped\fP is se
.IP "\fBf.warptoiconmgr\fP \fIstring\fP" 8
This function warps the pointer to the icon manager entry
associated with the window containing the pointer in the icon manager
-specified by the argument \fIstring\fP. If \fIstring\fP is empty (i.e. ""),
+specified by the argument \fIstring\fP. If \fIstring\fP is empty (i.e.\& ""),
the current icon manager is chosen.
.IP "\fBf.warptoscreen\fP \fIstring\fP" 8
This function warps the pointer to the screen specified by the
-argument \fIstring\fP. \fIString\fP may be a number (e.g. \fB"0"\fP or
+argument \fIstring\fP. \fIString\fP may be a number (e.g.\& \fB"0"\fP or
\fB"1"\fP), the word \fB"next"\fP (indicating the current screen plus 1,
skipping over any unmanaged screens),
the word \fB"back"\fP (indicating the current screen minus 1, skipping over
@@ -1183,7 +1209,6 @@ selected window is refreshed.
This function is similar to the \fBf.fullzoom\fP function, except that
the only the height of the selected window is changed.
.SH MENUS
-.PP
Functions may be grouped and interactively selected using pop-up
(when bound to a pointer button) or pull-down (when associated
with a titlebutton) menus. Each menu specification contains the name of the
@@ -1218,7 +1243,7 @@ The \fIfunction\fP portion of the menu e
including any user-defined functions, or additional menus.
.PP
There is a special menu named \fBTwmWindows\fP which contains the names of
-all of the client and \fItwm\fP-supplied windows. Selecting an entry will
+all of the client and \fItwm\fP\-supplied windows. Selecting an entry will
cause the
\fBWindowFunction\fP to be executed on that window. If \fBWindowFunction\fP
hasn't been set, the window will be deiconified and raised.
@@ -1235,7 +1260,7 @@ windows currently on the display. In ad
a small button using the default iconify symbol will be displayed to the
left of the name when the window is iconified. By default, clicking on an
entry in the icon manager performs \fBf.iconify\fP.
-To change the actions taken in the icon manager, use the
+To change the actions taken in the icon manager, use
the \fBiconmgr\fP context when specifying button and keyboard bindings.
.PP
Moving the pointer into the icon manager also directs keyboard focus to
@@ -1259,7 +1284,6 @@ If \fBIconifyByUnmapping\fP is on and wi
they may be lost if they are iconified and no bindings to
\fBf.menu "TwmWindows"\fP or \fBf.warpto\fP are setup.
.SH FILES
-.PP
.nf
.I $HOME/.twmrc.<screen number>
.I $HOME/.twmrc
@@ -1273,8 +1297,10 @@ during \fBf.exec\fP so that programs com
This variable is used as the prefix for files that begin with a tilde and
for locating the \fItwm\fP startup file.
.SH "SEE ALSO"
-.PP
-X(7), Xserver(1), xdm(1), xrdb(1)
+.BR X (7),
+.BR Xserver (1),
+.BR xdm (1),
+.BR xrdb (1)
.SH AUTHORS
Tom LaStrange, Solbourne Computer; Jim Fulton, MIT X Consortium;
Steve Pitschke, Stardent Computer; Keith Packard, MIT X Consortium;
Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)
[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>
The same goes for man pages that are used as an input.
For a style guide use
mandoc -T lint
-.-
Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
It should also check its input files for too long (> 80) lines.
This is just a simple quality control measure.
The "autogenerator" may have to be corrected to get a better man page,
the source file may, and any additional file may.
Common defects:
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
"git" has a "tool" to point out whitespace,
see for example "git-apply(1)" and git-config(1)")
Not beginning each input sentence on a new line.
Line length and patch size should thus be reduced.
The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.
See man-pages(7), item "semantic newline".
-.-
The difference between the formatted output of the original and patched file
can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -d -u <out1> <out2>
and for groff, using
\"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - \"
instead of 'nroff -mandoc'
Add the option '-t', if the file contains a table.
Read the output from 'diff -d -u ...' with 'less -R' or similar.
-.-.
If 'man' (man-db) is used to check the manual for warnings,
the following must be set:
The option \"-warnings=w\"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT=\"-ww -b -z\"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-
