[groff] 04/23: groff_www(7): Recast introduction; fix style nits.

[G. Branden Robinson]

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]]