[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#1037354: marked as done (X.7: some formatting fixes for the manual)

Your message dated Wed, 26 Mar 2025 18:22:02 +0000
with message-id <E1txVO6-0090Ha-Ik@fasolo.debian.org>
and subject line Bug#1037354: fixed in xorg-docs 1:1.7.3-1
has caused the Debian Bug report #1037354,
regarding X.7: some formatting fixes for the manual
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
1037354: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1037354
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
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

--- End Message ---
--- Begin Message --- 
Source: xorg-docs
Source-Version: 1:1.7.3-1
Done: Andreas Tille <tille@debian.org>

We believe that the bug you reported is fixed in the latest version of
xorg-docs, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 1037354@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Andreas Tille <tille@debian.org> (supplier of updated xorg-docs package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Format: 1.8
Date: Wed, 26 Mar 2025 18:43:33 +0100
Source: xorg-docs
Architecture: source
Version: 1:1.7.3-1
Distribution: unstable
Urgency: medium
Maintainer: Debian X Strike Force <debian-x@lists.debian.org>
Changed-By: Andreas Tille <tille@debian.org>
Closes: 888454 1037354 1040617 1098473
Changes:
 xorg-docs (1:1.7.3-1) unstable; urgency=medium
 .
   [ Andreas Tille ]
   * Team upload.
   * Fix Vcs fields
   * Fix typo in watch file
     Closes: #888454, #1040617
   * Standards-Version: 4.7.2 (routine-update)
   * debhelper-compat 13 (routine-update)
   * cme fix dpkg-control
   * Replace transitional package pkg-config by pkgconf in Build-Depends
     (routine-update)
   * Remove quilt, automake and autoconf from Build-Depends
   * d/watch: version=4
   * Source format: quilt (3.0)
   * d/rules: --fail-missing is default but specified in dh_missing
   * lbxalg.{html,txt,pdf} are not part of this version any more
   * Do not install irrelevant docs
   * Lintian-overrides: typo-in-manual-page Mor More
 .
   [ Timo Aaltonen ]
   * New upstream release.
 .
   [ Bjarni Ingi Gislason ]
   * Some formatting fixes for the manual
     Closes: #1037354
   * Editorial changes for man page
     Closes: #1098473
Checksums-Sha1:
 e76582f44fc7beda8ac1a9c2948d71fcf3cef704 2226 xorg-docs_1.7.3-1.dsc
 060b36c9415f396270f3352a9bff5b41e9ab89ba 460052 xorg-docs_1.7.3.orig.tar.gz
 1fbd65fb82f88eea4b01ccaf6a8c8ae2250b3643 833 xorg-docs_1.7.3.orig.tar.gz.asc
 6e50b04c951ce8e4b40f68087ff1a95bf1fcdefc 18320 xorg-docs_1.7.3-1.debian.tar.xz
 7c8340ee6118ba8331aa501b5dc8d6215d55ecac 7638 xorg-docs_1.7.3-1_amd64.buildinfo
Checksums-Sha256:
 cd1361ddec6d7b21765f8674b5bd8895f82dde8d0ef91267aa892015c1c672ef 2226 xorg-docs_1.7.3-1.dsc
 30f8fc4b435cda82f21d08d81c2e2fc9046ec7e20945e32ab7b63326674cf8c5 460052 xorg-docs_1.7.3.orig.tar.gz
 8591b4e854e58e479466008b8549d64db53add23985e85309d74af068eba7643 833 xorg-docs_1.7.3.orig.tar.gz.asc
 25a3fbcd9afd50514f18ac0f67886264c550a75811d3d941a0ced79192abe3d5 18320 xorg-docs_1.7.3-1.debian.tar.xz
 1de8228b1b7b833b2a6cecee51286ac3e2c2f663285bb920fe9eb8ffe4ca2612 7638 xorg-docs_1.7.3-1_amd64.buildinfo
Files:
 d1459f824085dc5ef1b42cd26e73dd38 2226 doc optional xorg-docs_1.7.3-1.dsc
 af041e3b46404be10efdd878b068849b 460052 doc optional xorg-docs_1.7.3.orig.tar.gz
 48b64508f6e200955c8fee956b5b0df6 833 doc optional xorg-docs_1.7.3.orig.tar.gz.asc
 a8228319952a6b6165bde4386a31da0f 18320 doc optional xorg-docs_1.7.3-1.debian.tar.xz
 d8dd84973ec807bf89da6808a6281580 7638 doc optional xorg-docs_1.7.3-1_amd64.buildinfo


-----BEGIN PGP SIGNATURE-----

iQJFBAEBCgAvFiEE8fAHMgoDVUHwpmPKV4oElNHGRtEFAmfkQLkRHHRpbGxlQGRl
Ymlhbi5vcmcACgkQV4oElNHGRtEfCQ/9EI8yrPSBYnCa4msCJPP2/+bBrivcMNWC
XfW6oAsx148j5k0Ej7LoRf0FS0PYU063qiO0QHI5pY0C5RxUDvIOZGoSeV5OvAi7
1K2VNKY5Ccr10t2McBZIF4bHfh1ZAilstSf56RCkOIYn01n3Ju+5CtBwOYADWQ+S
VSnj+7HsX97BDSLkH9R3/EBSfMyxCudZ6DpPI6BY3SG7UFc1aC4ts1pNA9a6GGCG
d3g0C22/v1lpm1oMUCbpGH4kF8f/kFeHfCeaABAV82ZSO6T15pgJrm5y6t+4PqYS
VyJTSNdhmDm1IUc4SO0H9Axqu1vN7bknn7GA2Ddb+17fSUyswJqAZpXXu/Mfnq5/
935FxYsvGJqmFbv5Oji05jLNl9nfSmT1gQiOGT1dk2DR+CSoVFtyEZrHcBfo6je7
2MV/uyyFdifxoae6Ug672FXmRgQwbwvuUGlE3HQGEcHS77IGKD1oSLTIzecyv6to
JQY1uBI+B7YLXrTSGgn8E0MBpF4+qK+ect83BJuh/C1/4Lo1DRR32P+u7a7L04Ht
zDd6a8kBhK3UTDKnKXEzn/tGQW0T53vsT6e7NKc6mC16TqvaueLvxf7gmCxEBbyM
wpfJ5ll53KyPYRDQo1JsLgTeeeMn5p0+POgV3z4ADg95Z2sNRjxtC3cGXXoQKEZo
XqDvxSxlN3o=
=5ooQ
-----END PGP SIGNATURE-----

Attachment: pgpLdXwTPVGjo.pgp
Description: PGP signature


--- End Message ---
Reply to: