xorg-docs: Changes to 'master'
GitLab Mirror
gitlab-mirror at kemper.freedesktop.org
Sat Apr 19 17:00:02 UTC 2025
general/ReleaseNotes.xml | 9
man/Consortium.man | 53 +--
man/Standards.man | 28 -
man/X.man | 749 +++++++++++++++++++++++++----------------------
man/XOrgFoundation.man | 32 +-
man/XProjectTeam.man | 38 +-
man/Xsecurity.man | 212 +++++++------
7 files changed, 615 insertions(+), 506 deletions(-)
New commits:
commit 90468ac98bc526e150a83f3c21d3e9ffd8444bf5
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date: Mon Apr 14 17:31:32 2025 -0700
Xsecurity.man: note that SUN-DES-1 support has been dropped
...in both Solaris 11.4.0 and in the 25.1 releases for the X servers.
Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>
Part-of: <https://gitlab.freedesktop.org/xorg/doc/xorg-docs/-/merge_requests/16>
commit 5f5e0fb50242799a11d4c0436cbe988b75ec248d
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date: Mon Apr 14 15:44:29 2025 -0700
Add Xwayland to lists of available X servers
Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>
Part-of: <https://gitlab.freedesktop.org/xorg/doc/xorg-docs/-/merge_requests/16>
commit 70fe2faf51d9fe926a41099db26ce5bddd785b37
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date: Sun Apr 13 16:26:58 2025 -0700
Remove Xdmx from lists of available X servers
It was removed from the xorg-server 21.1 and later releases.
Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>
Part-of: <https://gitlab.freedesktop.org/xorg/doc/xorg-docs/-/merge_requests/16>
commit 5298b529666c062bff22f48f0571fc53c12135b4
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date: Sun Apr 13 16:25:49 2025 -0700
Improve man page formatting
More closely follow common style as described on
https://man7.org/linux/man-pages/man7/man-pages.7.html
Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>
Part-of: <https://gitlab.freedesktop.org/xorg/doc/xorg-docs/-/merge_requests/16>
commit 8ba6e2c9c3933cc318eaad6be642140cdf65a9c7
Author: Bjarni Ingi Gislason <bjarniig at simnet.is>
Date: Thu Feb 20 23:23:23 2025 +0000
X.7: editorial changes for this man page [Debian bug #1098473]
Output from "mandoc -T lint X.7": (shortened list)
1 input text line longer than 80 bytes: a display server and...
1 input text line longer than 80 bytes: a font server and re...
1 input text line longer than 80 bytes: a variety of differe...
1 input text line longer than 80 bytes: keyboard description...
-.-.
Output from "test-groff -mandoc -t -ww -z X.7": (shortened list)
1 trailing space in the line
Remove trailing space with: sed -e 's/ *$//'
-.-.
Use "\e" to print the escape character instead of "\\" (which gets
interpreted in copy mode).
1003: /etc/X11/%L/%T/%N%C%S:\\
1004: /etc/X11/%l/%T/%N%C%S:\\
1005: /etc/X11/%T/%N%C%S:\\
1006: /etc/X11/%L/%T/%N%S:\\
1007: /etc/X11/%l/%T/%N%S:\\
1008: /etc/X11/%T/%N%S:\\
1009: /usr/share/X11/%L/%T/%N%C%S:\\
1010: /usr/share/X11/%l/%T/%N%C%S:\\
1011: /usr/share/X11/%T/%N%C%S:\\
1012: /usr/share/X11/%L/%T/%N%S:\\
1013: /usr/share/X11/%l/%T/%N%S:\\
1014: /usr/share/X11/%T/%N%S:\\
1015: /usr/lib/x86_64-linux-gnu/X11/%L/%T/%N%C%S:\\
1016: /usr/lib/x86_64-linux-gnu/X11/%l/%T/%N%C%S:\\
1017: /usr/lib/x86_64-linux-gnu/X11/%T/%N%C%S:\\
1018: /usr/lib/x86_64-linux-gnu/X11/%L/%T/%N%S:\\
1019: /usr/lib/x86_64-linux-gnu/X11/%l/%T/%N%S:\\
1044: $XAPPLRESDIR/%L/%N%C:\\
1045: $XAPPLRESDIR/%l/%N%C:\\
1046: $XAPPLRESDIR/%N%C:\\
1047: $HOME/%N%C:\\
1048: $XAPPLRESDIR/%L/%N:\\
1049: $XAPPLRESDIR/%l/%N:\\
1050: $XAPPLRESDIR/%N:\\
-.-.
Wrong distance 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.
N.B.
The number of lines affected can be too large to be in a patch.
Lines with only one (or two) space(s) between sentences are split,
so latter sentences begin on a new line.
[List of affected lines removed]
-.-
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 99, length 93
a font server and related utilities, \fIxfs\fP, \fIfsinfo\fP, \fIfslsfonts\fP, \fIfstobdf\fP;
Line 100, length 82
a display server and related utilities, \fIXserver\fP, \fIrgb\fP, \fImkfontdir\fP;
Line 102, length 83
keyboard description compiler and related utilities, \fIxkbcomp\fP, \fIsetxkbmap\fP
Line 360, length 87
a variety of different user interfaces can be built. The X.Org Foundation distribution
Line 414, length 83
\fI\-adobe\-courier\-medium\-r\-normal\-\-10\-100\-75\-75\-m\-60\-iso8859\-1\fP
Line 427, length 83
% xlsfonts \-fn \&'\-*\-courier\-medium\-r\-normal\-\-*\-100\-*\-*\-*\-*\-*\-*'
Line 500, length 95
\fI<red>\fP, \fI<green>\fP, \fI<blue>\fP := \fIh\fP | \fIhh\fP | \fIhhh\fP | \fIhhhh\fP
-.-.
Protect "^From " from forcing a mail software to use "quoted-printable"
encoding, by adding "\&" in front of it.
150:From the user's perspective, every X server has a \fIdisplay name\fP of the
-.-.
No need for "\&" to be in front of a period (.),
if there is a character in front of it
747:Binding = "\&." | "*"
756:Curly braces ({\&.\&.\&.}) indicate zero or more repetitions
758:Square brackets ([\&.\&.\&.\&]) indicate that the enclosed element is optional.
759:Quotes ("\&.\&.\&.\&") are used around literal characters.
-.-.
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.
218:.I "local"
-.-.
Section headings (.SH and .SS) do not need quoting.
116:.SH "STARTING UP"
149:.SH "DISPLAY NAMES"
231:.SH "ACCESS CONTROL"
280:.SH "GEOMETRY SPECIFICATIONS"
352:.SH "WINDOW MANAGERS"
367:.SH "FONT NAMES"
450:.SH "FONT SERVER NAMES"
466:.SH "COLOR NAMES"
1187:.SH "SEE ALSO"
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z ":
troff:<stdin>:54: warning: trailing space in the line
an.tmac:<stdin>:1082: style: 1 leading space(s) on input line
-.-.
Additionally:
Table: use left alignment as the differences in the width of data is substantial.
Generally:
Split (sometimes) lines after a punctuation mark; before a conjunction.
Reported-by: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1098473
Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>
Part-of: <https://gitlab.freedesktop.org/xorg/doc/xorg-docs/-/merge_requests/16>
commit 19af1a3609b4cf23b24d1ca8ba7b282a33b445c0
Author: Bjarni Ingi Gislason <bjarniig at simnet.is>
Date: Mon Jun 12 02:49:15 2023 +0000
X.7: some formatting fixes for the manual [Debian bug #1037354]
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
#####
Reported-by: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1037354
Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>
Part-of: <https://gitlab.freedesktop.org/xorg/doc/xorg-docs/-/merge_requests/16>
More information about the xorg-commit
mailing list