exa.man: editorial changes for this man page

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").

Mark a final abbreviation point as such by suffixing it with "\&".

25:Disables acceleration of uploading pixmap data to the framebuffer. Default: No.

-.-.

Split a punctuation mark from a single argument for a two-font macro

40:.BR xorg.conf(5).

-.-.

Section headings (.SH and .SS) do not need quoting.

38:.SH "SEE ALSO"

-.-.

Output from "test-groff  -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z ":

an.tmac:<stdin>:40: misuse, warning: .BR is for at least 2 arguments, got 1
	Use macro '.B' for one argument or split argument.

Originally from: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1095446

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Part-of: <https://gitlab.freedesktop.org/xorg/xserver/-/merge_requests/1875>
This commit is contained in:
Bjarni Ingi Gislason 2025-02-08 00:59:16 +00:00 committed by Alan Coopersmith
parent 359d12aa0b
commit 49378eb510

View File

@ -5,24 +5,30 @@
exa \- new 2D acceleration architecture for X.Org exa \- new 2D acceleration architecture for X.Org
.SH DESCRIPTION .SH DESCRIPTION
.B EXA .B EXA
provides a simple API for video drivers to implement for 2D acceleration. It provides a simple API for video drivers to implement for 2D acceleration.
is a module loaded by drivers, and is not intended to be loaded on its own. It is a module loaded by drivers,
and is not intended to be loaded on its own.
See your driver's manual page for how to enable See your driver's manual page for how to enable
.BR EXA . .BR EXA .
.PP .PP
The The
.B EXA .B EXA
architecture is designed to make accelerating the Render extension simple and architecture is designed to make accelerating the Render extension simple
efficient, and results in various performance tradeoffs compared to XAA. Some and efficient,
xorg.conf options are available for debugging performance issues or and results in various performance tradeoffs compared to XAA.
driver rendering problems. They are not intended for general use. Some xorg.conf options are available for debugging performance issues
or driver rendering problems.
They are not intended for general use.
.TP .TP
.BI "Option \*qEXANoComposite\*q \*q" boolean \*q .BI "Option \*qEXANoComposite\*q \*q" boolean \*q
Disables acceleration of the Composite operation, which is at the heart of Disables acceleration of the Composite operation,
the Render extension. Not related to the Composite extension. Default: No. which is at the heart of the Render extension.
Not related to the Composite extension.
Default: No.
.TP .TP
.BI "Option \*qEXANoUploadToScreen\*q \*q" boolean \*q .BI "Option \*qEXANoUploadToScreen\*q \*q" boolean \*q
Disables acceleration of uploading pixmap data to the framebuffer. Default: No. Disables acceleration of uploading pixmap data to the framebuffer.
Default: No.
.TP .TP
.BI "Option \*qEXANoDownloadFromScreen\*q \*q" boolean \*q .BI "Option \*qEXANoDownloadFromScreen\*q \*q" boolean \*q
Disables acceleration of downloading of pixmap data from the framebuffer. Disables acceleration of downloading of pixmap data from the framebuffer.
@ -31,11 +37,15 @@ Not usable with drivers which rely on DownloadFromScreen succeeding.
Default: No. Default: No.
.TP .TP
.BI "Option \*qMigrationHeuristic\*q \*q" anystr \*q .BI "Option \*qMigrationHeuristic\*q \*q" anystr \*q
Chooses an alternate pixmap migration heuristic, for debugging purposes. The Chooses an alternate pixmap migration heuristic,
default is intended to be the best performing one for general use, though others for debugging purposes.
may help with specific use cases. Available options include \*qalways\*q, The default is intended to be the best performing one for general use,
\*qgreedy\*q, and \*qsmart\*q. Default: always. though others may help with specific use cases.
.SH "SEE ALSO" Available options include \*qalways\*q,
\*qgreedy\*q,
and \*qsmart\*q.
Default: always.
.SH SEE ALSO
.BR Xorg (@appmansuffix@), .BR Xorg (@appmansuffix@),
.BR xorg.conf (@filemansuffix@). .BR xorg.conf (@filemansuffix@).
.SH AUTHORS .SH AUTHORS