Package: xorg-docs-core
Version: 1:1.7.1-1.2
Severity: minor
Tags: patch
Dear Maintainer,
here are some remarks and fixes.
Input file is X.7
Output from "mandoc -T lint X.7"
mandoc: X.7:39:2: WARNING: skipping paragraph macro: PP after SH
mandoc: X.7:100:93: STYLE: input text line longer than 80 bytes: a font server
and re...
mandoc: X.7:101:82: STYLE: input text line longer than 80 bytes: a display
server and...
mandoc: X.7:103:83: STYLE: input text line longer than 80 bytes: keyboard
description...
mandoc: X.7:118:2: WARNING: skipping paragraph macro: PP after SH
mandoc: X.7:152:2: WARNING: skipping paragraph macro: PP after SH
mandoc: X.7:234:2: WARNING: skipping paragraph macro: PP empty
mandoc: X.7:356:2: WARNING: skipping paragraph macro: PP empty
mandoc: X.7:365:87: STYLE: input text line longer than 80 bytes: a variety of
differe...
mandoc: X.7:595:2: WARNING: skipping paragraph macro: PP after SH
mandoc: X.7:695:4: WARNING: undefined escape, printing literally: \+
mandoc: X.7:898:2: WARNING: skipping paragraph macro: PP empty
mandoc: X.7:902:2: WARNING: skipping paragraph macro: PP empty
mandoc: X.7:906:2: WARNING: skipping paragraph macro: PP empty
mandoc: X.7:1197:2: WARNING: skipping paragraph macro: PP after SH
mandoc: X.7:1277:2: WARNING: skipping paragraph macro: PP after SH
mandoc: X.7:1280:2: WARNING: skipping paragraph macro: PP after SH
#######
Reduce space between words.
740:name, but with the first letter capitalized (e.g. \fIBitmap\fP or
\fIEmacs\fP)
#######
Increase size of ~ (tilde) to make it more visible
with "troff" by using character \(ti.
407: % cp newfont.pcf ~/myfonts
408: % mkfontdir ~/myfonts
576:CIEuvY:\fI<u>/<v>/<Y>\fP (~.6, ~.6, 1)
577:CIExyY:\fI<x>/<y>/<Y>\fP (~.75, ~.85, 1)
#####
Use "\e" to print the escape character instead of "\\" (which gets
interpreted in copy mode).
785:the two-character sequence ``\\\^\fIspace\fP'' (backslash followed by space)
787:and the two-character sequence ``\\\^\fItab\fP''
791:the two-character sequence ``\\\^n'' is recognized and replaced by a
794:the two-character sequence ``\\\^\fInewline\fP''
798:the four-character sequence ``\\\^\fInnn\fP'',
802:Finally, the two-character sequence ``\\\\'' is recognized
#####
Move a full stop (period) and a comma outside of a quoted text, if it is
at the end of the quote and does not end a quoted sentence.
635:This modifier is called the ``group modifier.''
Test nr. 26:
Find a repeated word
! 627 --> the
! 868 --> for
#####
Use \(en for a dash (en-dash) between space characters, not a minus
(\-) or a hyphen (-), except in the NAME section.
X.7:75:the \fIXlib - C Language X Interface\fP manual,
X.7:77:the \fIX Toolkit Intrinsics - C Language Interface\fP manual,
X.7:871:See the \fIX Toolkit Intrinsics - C Language Interface\fP manual for
#####
an.tmac:X.7:1091: style: 1 leading space(s) on input line
#####
--- X.7 2023-05-26 19:01:03.000000000 +0000
+++ X.7.new 2023-06-12 02:33:35.000000000 +0000
@@ -36,7 +36,6 @@
.SH NAME
X \- a portable, network-transparent window system
.SH OVERVIEW
-.PP
The X Window System is a network transparent window system which runs
on a wide range of computing and graphics machines. It should be
relatively straightforward to build the X.Org Foundation software
@@ -72,9 +71,9 @@ X supports overlapping hierarchical subw
graphics operations, on both monochrome and color
displays.
For a full explanation of the functions that are available, see
-the \fIXlib - C Language X Interface\fP manual,
+the \fIXlib \(en C Language X Interface\fP manual,
the \fIX Window System Protocol\fP specification,
-the \fIX Toolkit Intrinsics - C Language Interface\fP manual,
+the \fIX Toolkit Intrinsics \(en C Language Interface\fP manual,
and various toolkit documents.
.PP
The number of programs that use \fIX\fP is quite large.
@@ -115,7 +114,6 @@ as user-contributed software in the X.Or
available on the Internet.
See your site administrator for details.
.SH "STARTING UP"
-.PP
There are two main ways of getting the X server and an initial set of
client applications started. The particular method used depends on what
operating system you are running and whether or not you use other window
@@ -149,7 +147,6 @@ finish. Since either or both of the use
script, this gives substantial flexibility at the expense of a
nice interface. For this reason, \fIxinit\fP is not intended for end users.
.SH "DISPLAY NAMES"
-.PP
From the user's perspective, every X server has a \fIdisplay name\fP of the
form:
.sp
@@ -231,7 +228,6 @@ hostname or IP address. Full Internet n
addresses, and IPv6 addresses are all allowed. For example:
\fIx.org:0\fP, \fIexpo:0\fP, \fI[::1]:0\fP,
\fI198.112.45.11:0\fP, \fIbigmachine:1\fP, and \fIhydra:0.1\fP.
-.PP
.SH "ACCESS CONTROL"
An X server can use several types of access control. Mechanisms provided
in Release 7 are:
@@ -353,7 +349,6 @@ hand corner:
xload \-geometry 48x48\-96+0 &
xbiff \-geometry 48x48\-48+0 &
.fi
-.PP
.SH "WINDOW MANAGERS"
The layout of windows on the screen is controlled by special programs called
\fIwindow managers\fP. Although many window managers will honor geometry
@@ -404,8 +399,8 @@ font database, reset the font path with
to add a font to a private directory, the following commands could be used:
.sp
.nf
- % cp newfont.pcf ~/myfonts
- % mkfontdir ~/myfonts
+ % cp newfont.pcf \(ti/myfonts
+ % mkfontdir \(ti/myfonts
% xset fp rehash
.fi
.PP
@@ -573,8 +568,8 @@ the following syntax:
center;
l l.
CIEXYZ:\fI<X>/<Y>/<Z>\fP (\fInone\fP, 1, \fInone\fP)
-CIEuvY:\fI<u>/<v>/<Y>\fP (~.6, ~.6, 1)
-CIExyY:\fI<x>/<y>/<Y>\fP (~.75, ~.85, 1)
+CIEuvY:\fI<u>/<v>/<Y>\fP (\(ti.6, \(ti.6, 1)
+CIExyY:\fI<x>/<y>/<Y>\fP (\(ti.75, \(ti.85, 1)
CIELab:\fI<L>/<a>/<b>\fP (100, \fInone\fP, \fInone\fP)
CIELuv:\fI<L>/<u>/<v>\fP (100, \fInone\fP, \fInone\fP)
TekHVC:\fI<H>/<V>/<C>\fP (360, 100, 100)
@@ -592,7 +587,6 @@ followed by an optional '+' or '\-' foll
For more information on device independent color,
see the \fIXlib\fP reference manual.
.SH KEYBOARDS
-.PP
The X keyboard model is broken into two layers: server-specific codes
(called \fIkeycodes\fP) which represent the physical keys, and
server-independent symbols (called \fIkeysyms\fP) which
@@ -623,7 +617,7 @@ The first four elements of the list are
Group 1 contains the first and second keysyms;
Group 2 contains the third and fourth keysyms.
Within each group,
-if the first element is alphabetic and the
+if the first element is alphabetic and
the second element is the special keysym \fINoSymbol\fP,
then the group is treated as equivalent to a group in which
the first element is the lowercase letter and the second element
@@ -632,7 +626,7 @@ is the uppercase letter.
Switching between groups is controlled by the keysym named MODE SWITCH,
by attaching that keysym to some key and attaching
that key to any one of the modifiers Mod1 through Mod5.
-This modifier is called the ``group modifier.''
+This modifier is called the ``group modifier''.
Group 1 is used when the group modifier is off,
and Group 2 is used when the group modifier is on.
.PP
@@ -692,7 +686,7 @@ possible, often by swapping the foregrou
programs honor this or implement it correctly. It is usually only used on
monochrome displays.
.TP 8
-.B \+rv
+.B +rv
.br
This option indicates that the program should not simulate reverse video.
This is used to
@@ -737,7 +731,7 @@ Program components are named in a hierar
with each node in the hierarchy identified by a class and an instance name.
At the top level is the class and instance name of the application itself.
By convention, the class name of the application is the same as the program
-name, but with the first letter capitalized (e.g. \fIBitmap\fP or \fIEmacs\fP)
+name, but with the first letter capitalized (e.g. \fIBitmap\fP or \fIEmacs\fP)
although some programs that begin with the letter ``x'' also capitalize the
second letter for historical reasons.
.PP
@@ -782,24 +776,24 @@ same ResourceName, the last line in the
Any whitespace character before or after the name or colon in a ResourceSpec
are ignored.
To allow a Value to begin with whitespace,
-the two-character sequence ``\\\^\fIspace\fP'' (backslash followed by space)
+the two-character sequence ``\e\^\fIspace\fP'' (backslash followed by space)
is recognized and replaced by a space character,
-and the two-character sequence ``\\\^\fItab\fP''
+and the two-character sequence ``\e\^\fItab\fP''
(backslash followed by horizontal tab)
is recognized and replaced by a horizontal tab character.
To allow a Value to contain embedded newline characters,
-the two-character sequence ``\\\^n'' is recognized and replaced by a
+the two-character sequence ``\e\^n'' is recognized and replaced by a
newline character.
To allow a Value to be broken across multiple lines in a text file,
-the two-character sequence ``\\\^\fInewline\fP''
+the two-character sequence ``\e\^\fInewline\fP''
(backslash followed by newline) is
recognized and removed from the value.
To allow a Value to contain arbitrary character codes,
-the four-character sequence ``\\\^\fInnn\fP'',
+the four-character sequence ``\e\^\fInnn\fP'',
where each \fIn\fP is a digit character in the range of ``0''\-``7'',
is recognized and replaced with a single byte that contains
the octal value specified by the sequence.
-Finally, the two-character sequence ``\\\\'' is recognized
+Finally, the two-character sequence ``\e\e'' is recognized
and replaced with a single backslash.
.PP
When an application looks for the value of a resource, it specifies
@@ -865,10 +859,10 @@ or the environment variable XAPPLRESDIR
directory and should end with a '/' on POSIX systems), plus directories in a
standard place (usually under /usr/share/X11/,
but this can be overridden with the XFILESEARCHPATH environment variable)
-are searched for for application-specific resources.
+are searched for application-specific resources.
For example, application default resources are usually kept in
/usr/share/X11/app-defaults/.
-See the \fIX Toolkit Intrinsics - C Language Interface\fP manual for
+See the \fIX Toolkit Intrinsics \(en C Language Interface\fP manual for
details.
.TP 8
.B XENVIRONMENT
@@ -895,15 +889,12 @@ begins with a lowercase letter and class
Multiple word resources are concatenated with the first letter of the
succeeding words capitalized. Applications written with the X Toolkit
Intrinsics will have at least the following resources:
-.PP
.TP 8
.B background (\fPclass\fB Background)
This resource specifies the color to use for the window background.
-.PP
.TP 8
.B borderWidth (\fPclass\fB BorderWidth)
This resource specifies the width in pixels of the window border.
-.PP
.TP 8
.B borderColor (\fPclass\fB BorderColor)
This resource specifies the color to use for the window border.
@@ -1088,7 +1079,7 @@ The default value is\fI /usr/share/X11/X
.TP
.B XCMSDB
This must point to a color name database file. The default value is
-\fI /usr/lib/x86_64-linux-gnu/X11/Xcms.txt\fP.
+\fI/usr/lib/x86_64-linux-gnu/X11/Xcms.txt\fP.
.TP
.B RESOURCE_NAME
This serves as main identifier for resources belonging to the program
@@ -1194,7 +1185,6 @@ the appropriate instance name can be pla
xterm*StringConversionWarnings: on
.fi
.SH "SEE ALSO"
-.PP
.\" introductions
.BR XOrgFoundation (7),
.BR XStandards (7),
@@ -1274,10 +1264,8 @@ the appropriate instance name can be pla
and
.I "X Toolkit Intrinsics \- C Language Interface"
.SH TRADEMARKS
-.PP
X Window System is a trademark of The Open Group.
.SH AUTHORS
-.PP
A cast of thousands, literally. Releases 6.7 and later are
brought to you by the X.Org Foundation. The names of all people who
made it a reality will be found in the individual documents and
-- System Information:
Debian Release: 12.0
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.1.27-1 (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)
xorg-docs-core depends on no packages.
xorg-docs-core recommends no packages.
Versions of packages xorg-docs-core suggests:
pn xorg-docs <none>
-- no debconf information
