Commit graph

27 commits

Author SHA1 Message Date
Alan Coopersmith
e003f52661 man pages: Use .BR markup for references to other man pages
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Part-of: <https://gitlab.freedesktop.org/xorg/lib/libx11/-/merge_requests/286>
2025-07-13 10:57:31 -07:00
Walter Harms
b7ec67d3ea FIX: warning: macro `IN' not defined
just remove an other dead macro use.
2020-11-27 22:26:15 +01:00
Walter Harms
14fb4e5356 FIX: warning: macro `hN' not defined
this was found by checking man pages with
 groff -t -mandoc -Z  -wmac -Tutf8 $FILE >/dev/null

In most cases .hN could be replaced with .BR

Signed-off-by: Walter Harms <wharms@bfs.de>
2020-11-27 20:04:22 +01:00
Walter Harms
cb03da4447 FIX: warning: macro `Pn' not defined
The missing macro is found via:
roff -t -mandoc -Z  -wmac -Tutf8 XAnyEvent.man >/dev/null

To fix the problem the macro is replaced with .RB.

Signed-off-by: Walter Harms <wharms@bfs.de>
2020-11-27 19:00:00 +01:00
Christopher Chavez
780d222343 Fix typo GCCLipYOrigin -> GCClipYOrigin in XCreateGC() manpage 2020-08-10 17:08:39 +00:00
Thomas E. Dickey
f111bf3ac0
improve some formatting
Signed-off-by: Thomas E. Dickey <dickey@invisible-island.net>
2019-07-30 16:53:27 -04:00
Thomas E. Dickey
8fe8aafe7e
split lines at sentence endings
Signed-off-by: Thomas E. Dickey <dickey@invisible-island.net>
2019-07-30 05:07:40 -04:00
Thomas E. Dickey
6f2cbcea5d
trim trailing whitespace from manpages
Signed-off-by: Thomas E. Dickey <dickey@invisible-island.net>
2019-07-30 04:52:25 -04:00
Walter Harms
705027ea9b get rid of ``fake quotes''
these fake quotes are inside a comment and can be replaced with
some double quotes

Signed-off-by: Walter Harms <wharms@bfs.de>
2019-07-29 18:27:12 +02:00
Walter Harms
fe46eb2871 remove all private macro defines
after converting everything to st. man page macros there is
no need to maintain X11 private nroff macros, so remove them.

Signed-off-by: Walter Harms <wharms@bfs.de>
2019-07-29 17:57:02 +02:00
Walter Harms
b7f09ae19c Replace home-grown .Ds .De macro with man page .EX/.EE macro
Same pages use the man page .EX/.EE macro. Replace all occurences
of .De/.Ds with the std. macros to make the code better to maintain.

Signed-off-by: Walter Harms <wharms@bfs.de>
2019-07-29 17:47:35 +02:00
Walter Harms
4eb167f5ac replace home grown .ZN with std, .B and .BR
Replace the home grown macro .ZN with std. macros
from man macro paket. So we can get rid of the
definition an get a clean header.

Signed-off-by: Walter Harms <wharms@bfs.de>
2019-07-03 18:18:09 +02:00
Walter Harms
08e6b36292 remove in-text macros
remove in-text macros an fix a few typos on the way.
hopefuly that will make maintenance more easy.

Signed-off-by: Walter Harms <wharms@bfs.de>
2019-06-22 18:33:48 +02:00
Alan Coopersmith
280274e529 XCreateGC.man: simplify table to work with Solaris tbl
Having every table cell be a text diversion (T{...T}) was too much for
Solaris tbl to handle, and thus "man XCreateGC" would print the error
/usr/man/man3x11/XCreateGC.3x11: line 402: Too many text block diversions
tbl quits
and not display the table of mask bits or any text in the man page after
that table.   Since the #define column doesn't need special handling,
making it not use text diversions brings the table under the tbl limit.

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-05-20 21:30:57 -07:00
Thomas Klausner
96dcf747f1 XCreateGC man page: Avoid .TS H and .TH macros
Avoid .TS H and .TH for now as it doesn't alter the output in this case,
and improve the output with mandoc(1).

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2013-06-02 16:18:33 -07:00
Eric S. Raymond
b686600ab5 The .NT/.NE macro pair is no longer used. Remove it.
Signed-off-by: Eric S. Raymond <esr@thyrsus.com>
2012-08-23 10:53:33 -04:00
Eric S. Raymond
e9509fa674 The .C{ and .C} macros are never used. Remove them.
Signed-off-by: Eric S. Raymond <esr@thyrsus.com>
2012-08-23 10:23:45 -04:00
Eric S. Raymond
6b2f7ddeea The .FN macro, paired with .FD, is also never used. Remove it.
Signed-off-by: Eric S. Raymond <esr@thyrsus.com>
2012-08-23 10:08:08 -04:00
Eric S. Raymond
cac6572701 The ".FD" macro is never used. Remove it.
It was a temptation to presentation-level klugery and is best gone.

Signed-off-by: Eric S. Raymond <esr@thyrsus.com>
2012-08-23 10:03:00 -04:00
Eric S. Raymond
a7fb575957 Eliminate all uses of tab stops in the libX11 man pages.
Two steps: First, expand tabs to 8 spaces in code and structure
listings.  Second, make the .Ds used to wrap code listings switch to
constant-width font (CW) rather than numeric font position 1, which
maps to R on most systems.

It is possible some archaic systems won't know what CW is, but the
only risk is that code listings won't look quite right on troff
devices; the PostScript and DVI drivers definitely grok it, so those
important cases are OK.

The purpose of these changes is to get rid of presentation-level
markup so these pages will lift clean to DocBook.

Signed-off-by: Eric S. Raymond <esr@thyrsus.com>
2012-08-23 08:24:17 -04:00
Alan Coopersmith
ddb1786720 Purge CVS/RCS id tags
Signed-off-by: Alan Coopersmith <alan.coopersmith@sun.com>
2010-01-14 17:38:26 -08:00
Julien Cristau
54c64267cc man: fix XCopyGC argument order
Ubuntu bug#408337
2009-10-29 17:41:02 +01:00
Julien Cristau
ee723b83b2 man: use __libmansuffix__ instead of 3X11 for references to other pages 2009-08-05 16:48:32 +02:00
Alan Coopersmith
4b91ed0995 X.Org Bug #4312: incorrect comment asterisk in XAnyEvent.3x man page
X.Org Bugzilla #4312 <http://bugs.freedesktop.org/show_bug.cgi?id=4312>

Protect /* sequences from cpp pre-processor removal without transforming
to Unicode mathematical asterisk character
2007-11-21 16:50:04 -08:00
David Nusinow
e17c2cbe9f Dynamically generate internal manpage section using __libmanpagesuffix__ so that it actually matches the section if you don't use 3X11 2006-10-10 22:11:05 -04:00
Egbert Eich
c6349f4319 Merging XORG-CURRENT into trunk 2004-04-23 18:42:09 +00:00
Kaleb Keithley
deae12c6b6 R6.6 is the Xorg base-line 2003-11-14 15:54:30 +00:00