[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 04/23: groff_www(7): Recast introduction; fix style nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 04/23: groff_www(7): Recast introduction; fix style nits. |
Date: |
Mon, 21 Mar 2022 03:44:54 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit fd326a58a8b9e734b9c49931575f22c0ba43d6ce
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Mar 19 19:13:56 2022 +1100
groff_www(7): Recast introduction; fix style nits.
* Set "groff" in italics.
* Set metasyntactic parameter names in italics in macro synopsis (in one
instance; many others require correction).
---
tmac/groff_www.7.man | 43 ++++++++++++++++++++++++-------------------
1 file changed, 24 insertions(+), 19 deletions(-)
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index 99204c19..7ff6ed68 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -49,28 +49,30 @@ This manual page describes the GNU
.I www
macro package,
which is part of the
-.I groff
+.MR groff @MAN7EXT@
document formatting system.
.
-The manual page is very a basic guide, and the HTML device driver
-.RI ( \%grohtml )
-has been completely rewritten but still remains as in an alpha state.
-.
-It has been included into the distribution so that a lot of people have
-a chance to test it.
-.
-Note that this macro file is automatically called (via the
+This macro file is automatically loaded by the default
.I troffrc
-file) if you use
+file when the formatter
+(usually
+.MR groff @MAN1EXT@ )
+is called with either of the options
.B \-Thtml
or
.BR \-Txhtml .
.
+To see hyperlinks in action,
+format this man page using one of those options.
.
-.PP
-To see the hyperlinks in action, please format this man page with the
-.I \%grohtml
-device.
+.
+.P
+This document is a basic guide;
+the HTML output driver
+.RI ( \%grohtml )
+remains in an alpha state.
+.
+It has been included with the distribution to encourage testing.
.
.
.PP
@@ -174,10 +176,11 @@ Another method for turning automatic headings off is by
issuing the
command-line switch
.B \-P\-l
to
-.BR groff .
+.IR groff .
+.
.
.TP
-.B .BCL foreground background active not-visited visited
+.BI .BCL\~ "foreground background active not-visited visited"
This macro takes five parameters:
foreground,
background,
@@ -273,8 +276,9 @@ can be achieved by the following macro:
.RE
.
.IP
-Note that all the URLs actually are treated as consuming no textual
-space in groff.
+All URLs currently are treated as consuming no textual
+space in
+.IR groff .
.
This could be considered as a bug since it causes some problems.
.
@@ -390,7 +394,8 @@ or
.B \-Txhtml
it is necessary to use the
.B \-U
-option of groff.
+option of
+.IR groff .
.
.TP
.B .MPIMG [\-R|\-L] [\-G gap] filename [width [height]]
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 04/23: groff_www(7): Recast introduction; fix style nits.,
G. Branden Robinson <=