From 7ca66dd2987146f597f29ffdbc00dcd3084fecb4 Mon Sep 17 00:00:00 2001 From: "G. Branden Robinson" Date: Sun, 5 Nov 2017 08:03:46 -0500 Subject: man pages: Rationalize author sections. Part 1 of a man page author and copyright information overhaul; see https://lists.gnu.org/archive/html/groff/2017-11/msg00013.html et seq. Thanks to Werner Lemberg, Ingo Schwarze, and Ralph Corderoy for their feedback and support. * Stop defining page-local "au" macros to store author information. * Instead, move it directly inline in the page, as is common practice elsewhere. I made several cleanups along the way, but only to material in the AUTHORS section: * Researched (insofar as I was able) and added program and macro package author information. Something seems slightly wrong to me to have a man page that documents some other work and then identify only the authors of the man page itself. (By contrast, some section 5 and 7 man pages are sui generis.) * Where the page documented a GNU reimplementation of a historical roff work (program or macro package), clarify the point. * Don't refer to the original Berkeley grn as @g@grn; it'll be wrong if anyone sets the program prefix. * Discuss "this document" or a program rather than "this file". * Changed inline email addresses to use MT/ME macros. * Escaped hyphens in arguments to MT and UR macros. * Dropped unnecessary quotation marks from the argument to SH. * Call the section AUTHORS even if there is only one author, for consistency and future-proofing. This is what the man-pages project folks call it, too, even though they discourage its use. * Added discretionary hyphenless breakpoints to MT and UR macros (not comprehensively, though). * Set the page's own name in bold where this was not already done. * Set references to software tools and systems in italics where they were not (1) man page cross references; or (2) the topic of the immediate page. * Relocate AUTHORS section to immediately precede SEE ALSO section. Signed-off-by: G. Branden Robinson --- tmac/groff_trace.7.man | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) (limited to 'tmac/groff_trace.7.man') diff --git a/tmac/groff_trace.7.man b/tmac/groff_trace.7.man index 9e8a7be47..5bd6a5da7 100644 --- a/tmac/groff_trace.7.man +++ b/tmac/groff_trace.7.man @@ -29,12 +29,6 @@ A copy of the Free Documentation License is included as a file called FDL in the main directory of the groff source package. .. . -.de au -Written by -.MT groff\-bernd.warken\-72@web.de -Bernd Warken -.ME . -.. . .ds Ellipsis .\|.\|.\&\" . @@ -286,6 +280,19 @@ for details. . . .\" ==================================================================== +.SH AUTHORS +.\" ==================================================================== +The +.I trace +macro packages was written by James Clark. +. +This document was written by +.MT groff\-bernd.warken\-72@web.de +Bernd Warken +.ME . +. +. +.\" ==================================================================== .SH "SEE ALSO" .\" ==================================================================== . @@ -321,10 +328,6 @@ file. .SH COPYING .\" ==================================================================== .co -.\" ==================================================================== -.SH AUTHORS -.\" ==================================================================== -.au . . .cp \n[groff_C] -- cgit v1.2.1