[groff] 01/01: man pages: Set several abbreviations in caps.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 35a5d8f1b38ed77e62138fe29a4704143608bbfb
Author: G. Branden Robinson <address@hidden>
Date:   Mon Nov 6 05:54:59 2017 -0500

    man pages: Set several abbreviations in caps.
    
    When not used as literals or metasyntactic variables, set the
    abbreviations DVI, FTP, HTML, PDF, PNG, URL, and XHTML in capitals.
    
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 contrib/glilypond/glilypond.1.man |  8 +++----
 contrib/groffer/groffer.1.man     | 30 ++++++++++++-------------
 contrib/groffer/roff2.1.man       |  2 +-
 src/devices/grodvi/grodvi.1.man   | 14 ++++++------
 src/devices/grohtml/grohtml.1.man | 20 ++++++++---------
 src/roff/groff/groff.1.man        |  4 ++--
 tmac/groff_www.7.man              | 46 +++++++++++++++++++--------------------
 7 files changed, 62 insertions(+), 62 deletions(-)

diff --git a/contrib/glilypond/glilypond.1.man 
b/contrib/glilypond/glilypond.1.man
index 6323c97..f52f55b 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -87,7 +87,7 @@ Together with
 .B glilypond can work only for
 .I troff
 devices without
-.I pdf
+.I PDF
 and
 .I X
 devices.
@@ -132,7 +132,7 @@ option
 does not work and the
 .B groffer
 default
-.I pdf
+.I PDF
 works neither.
 .
 .
@@ -198,7 +198,7 @@ This is the default.
 The program
 .B glilypond
 generates a
-.I pdf
+.I PDF
 file using
 .BR lilypond .
 .
@@ -688,7 +688,7 @@ In this mode, the
 files are transformed by the
 .BR lilypond (1)
 program into
-.I pdf
+.I PDF
 files, using
 .RS
 .EX
diff --git a/contrib/groffer/groffer.1.man b/contrib/groffer/groffer.1.man
index ef50b84..f9d84cd 100644
--- a/contrib/groffer/groffer.1.man
+++ b/contrib/groffer/groffer.1.man
@@ -146,13 +146,13 @@ native \%\f(CRX\~Window\fP viewer
 .BR \%gxditview (@MAN1EXT@),
 each
 .IR \%PostScript ,
-.IR \%pdf ,
+.IR \%PDF ,
 or
-.I \%dvi
+.I \%DVI
 display program, a web browser by generating
-.I \%html
+.I \%HTML
 or
-.I \%xhtml
+.I \%XHTML
 in
 .IR \%www\~mode ,
 or several
@@ -608,7 +608,7 @@ Equivalent to
 .BR \-\-mode=\%dvi .
 .
 Known \%\f(CRX\~Window\fP
-.I \%dvi
+.I \%DVI
 viewers include
 .BR \%xdvi (1)
 and
@@ -652,7 +652,7 @@ when a different mode was specified before.
 .TP
 .B dvi
 Display formatted input in a
-.I \%dvi
+.I \%DVI
 viewer program.
 .
 By default, the formatted input is displayed with the
@@ -675,7 +675,7 @@ viewing features.
 .
 .TP
 .B html
-Translate the input into html format and display the result in a web
+Translate the input into HTML format and display the result in a web
 browser program.
 .
 By default, the existence of a sequence of standard web browsers is
@@ -683,7 +683,7 @@ tested, starting with
 .BR \%konqueror (1)
 and
 .BR \%mozilla (1).
-The text html viewer is
+The text HTML viewer is
 .BR \%lynx (1).
 .
 By default, the existence of a sequence of standard web browsers is
@@ -691,7 +691,7 @@ tested, starting with
 .BR \%konqueror (1)
 and
 .BR \%mozilla (1).
-The text html viewer is
+The text HTML viewer is
 .BR \%lynx (1).
 .
 .
@@ -825,14 +825,14 @@ Equivalent to
 .TP
 .B xhtml
 Translate the input into
-.I xhtml
+.I XHTML
 format, which is an
 .I XML
 version of
-.IR html .
+.IR HTML .
 .
 Then display the result in a web browser program, mostly the known
-.IR "html viewers" .
+.IR "HTML viewers" .
 .
 .
 .P
@@ -2070,7 +2070,7 @@ in a PDF viewer
 in a web browser
 .nh
 .RI ( html ,
-.RI ( xhtml
+.RI ( xhtml ,
 or
 .IR \%www\~mode )
 .hy
@@ -2093,7 +2093,7 @@ or
 .IR \%x\~mode )
 .
 .IP \*(BU 2m
-in a dvi viewer program
+in a DVI viewer program
 .nh
 .RI ( \%dvi\~mode )
 .hy
@@ -3857,7 +3857,7 @@ Viewers for
 Web-browsers for
 .BR \%groffer 's
 .IR \%html ,
-.IR \%xhtml
+.IR \%xhtml ,
 or
 .IR \%www\~mode .
 .
diff --git a/contrib/groffer/roff2.1.man b/contrib/groffer/roff2.1.man
index 42d84c6..606d4d0 100644
--- a/contrib/groffer/roff2.1.man
+++ b/contrib/groffer/roff2.1.man
@@ -139,7 +139,7 @@ mode.
 .  TP
 .  BR \%roff2html (@MAN1EXT@)
 generates
-.  I html
+.  I HTML
 output.
 .\}
 .
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index 851fb10..ec17325 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -1,6 +1,6 @@
 .TH GRODVI @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
 .SH NAME
-grodvi \- convert groff output to TeX dvi format
+grodvi \- convert groff output to TeX DVI format
 .
 .\" copying (license)
 .\"
@@ -76,7 +76,7 @@ parameter.
 .B grodvi
 is a driver for
 .B groff
-that produces \*(tx dvi format.
+that produces \*(tx DVI format.
 .
 Normally it should be run by
 .BR groff\ \-Tdvi .
@@ -87,9 +87,9 @@ it will also input the macros in
 .BR @MACRODIR@/dvi.tmac .
 .
 .LP
-The dvi file generated by
+The DVI file generated by
 .B grodvi
-can be printed by any correctly-written dvi driver.
+can be printed by any correctly-written DVI driver.
 .
 The troff drawing primitives are implemented
 using the tpic version\~2 specials.
@@ -110,7 +110,7 @@ at the current position
 .
 Afterwards the current position will be at the opposite corner.
 .
-This produces a rule in the dvi file and so can be printed even with a
+This produces a rule in the DVI file and so can be printed even with a
 driver that does not support the tpic specials unlike the other
 .B \[rs]D
 commands.
@@ -118,7 +118,7 @@ commands.
 .LP
 The groff command
 .BI \[rs]X' anything '
-is translated into the same command in the dvi file as would be
+is translated into the same command in the DVI file as would be
 produced by
 .BI \[rs]special{ anything }
 in \*(tx;
@@ -441,7 +441,7 @@ use a different resolution (57816 units per inch) to those 
produced by
 \*(tx.
 .
 Incorrectly written drivers which assume the resolution used by \*(tx,
-rather than using the resolution specified in the dvi file will not
+rather than using the resolution specified in the DVI file will not
 work with
 .BR grodvi .
 .
diff --git a/src/devices/grohtml/grohtml.1.man 
b/src/devices/grohtml/grohtml.1.man
index ee9a681..234c663 100644
--- a/src/devices/grohtml/grohtml.1.man
+++ b/src/devices/grohtml/grohtml.1.man
@@ -1,6 +1,6 @@
 .TH GROHTML @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
 .SH NAME
-grohtml \- html driver for groff
+grohtml \- HTML driver for groff
 .
 .
 .\" license
@@ -50,7 +50,7 @@ grohtml \- html driver for groff
 .OP \-o \%image-vertical-offset
 .OP \-s size
 .OP \-S level
-.OP \-x \%html-dialect
+.OP \-x \%HTML-dialect
 .RI "[\ " files\|.\|.\|. "\ ]"
 .br
 .ad \na
@@ -68,7 +68,7 @@ and a device driver,
 .BR post-grohtml )
 translates the output of GNU
 .B troff
-to html.
+to HTML.
 .
 Users should always invoke
 .B grohtml
@@ -133,7 +133,7 @@ appear inside a table or equation.
 .BI \-a aa-text-bits
 Number of bits of antialiasing information to be used by
 .I text
-when generating png images.
+when generating PNG images.
 .
 The default is\~4 but valid values are 0, 1, 2, and\~4.
 .
@@ -192,7 +192,7 @@ is the name of the device, usually
 .BI \-g aa-graphic-bits
 Number of bits of antialiasing information to be used by
 .I graphics
-when generating png images.
+when generating PNG images.
 .
 The default is\~4 but valid values are 0, 1, 2, and\~4.
 .
@@ -242,7 +242,7 @@ is the process ID).
 .BI \-j filename
 Inform
 .B grohtml
-to split the html output into multiple files.
+to split the HTML output into multiple files.
 .
 The
 .I filename
@@ -279,14 +279,14 @@ only displays a page number when an image is required.
 .
 .TP
 .B \-r
-Turn off the automatic header and footer line (html rule).
+Turn off the automatic header and footer line (HTML rule).
 .
 .TP
 .B \-s size
 Set the base point size of the source file.
 .
 Thereafter when this point size is used in the source it will
-correspond to the html base size.
+correspond to the HTML base size.
 .
 Every increase of two points in the source will yield a
 .B <big>
@@ -296,7 +296,7 @@ tag is emitted.
 .
 .TP
 .BI \-S level
-When splitting html output,
+When splitting HTML output,
 split at the heading level (or higher) defined by
 .IR level .
 .
@@ -359,7 +359,7 @@ mounted at font positions 1 to\~4.
 .\" ====================================================================
 .
 .B grohtml
-is dependent upon the png utilities
+is dependent upon the PNG utilities
 .RB ( \%pnmcut ,
 .BR \%pnmcrop ,
 .BR \%pnmtopng )
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index d5e0e31..6f37828 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -1685,10 +1685,10 @@ documentation directory
 directory for examples
 .TP
 .B @HTMLDOCDIR@
-documentation directory for html files
+documentation directory for HTML files
 .TP
 .B @PDFDOCDIR@
-documentation directory for pdf files
+documentation directory for PDF files
 .TP
 .B @DATASUBDIR@
 data subdirectory
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index e5f0dbb..89ee7a5 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -56,7 +56,7 @@ file ...
 This manual page describes the GNU \-mwww macro package, which is part of
 the groff document formatting system.
 .
-The manual page is very a basic guide, and the html device driver
+The manual page is very a basic guide, and the HTML device driver
 .RB ( \%grohtml )
 has been completely rewritten but still remains as in an alpha state.
 .
@@ -86,14 +86,14 @@ l l.
 \&address@hidden heading level cut off
 \&address@hidden colours on a web page
 \&address@hidden background image
-\&address@hidden a url using two parameters
-\&address@hidden an ftp reference
-\&address@hidden a html email address
-\&address@hidden an ftp reference
-\&address@hidden an html name
+\&address@hidden a URL using two parameters
+\&address@hidden an FTP reference
+\&address@hidden a HTML email address
+\&address@hidden an FTP reference
+\&address@hidden an HTML name
 \&address@hidden an image file
-\&address@hidden png image
-\&address@hidden png on the margin and wrap text around it
+\&address@hidden PNG image
+\&address@hidden PNG on the margin and wrap text around it
 \&address@hidden heading
 \&address@hidden heading
 \&address@hidden automatically collected links.
@@ -109,13 +109,13 @@ l l.
 \&address@hidden list end
 \&address@hidden a list item
 \&address@hidden a drop capital
-\&address@hidden an html raw request to the device driver
+\&address@hidden an HTML raw request to the device driver
 \&address@hidden example begin
 \&address@hidden example end
 \&address@hidden links on left of main text.
 \&address@hidden a new two-column table with links in the left.
 \&address@hidden the two-column table.
-\&address@hidden default url attributes.
+\&address@hidden default URL attributes.
 .TE
 .
 .
@@ -201,7 +201,7 @@ If
 and
 .B after
 are absent then the
-.B url
+.B URL
 becomes the anchor text.
 .
 Hyphenation is disabled while printing the actual URL;
@@ -238,7 +238,7 @@ by:
 .
 .TP
 .B .MTO address [description] [after]
-Generate an email html reference.
+Generate an email HTML reference.
 .
 The first argument is mandatory as the email address.
 .
@@ -276,9 +276,9 @@ or
 .
 .TP
 .B .FTP url [description] [after]
-indicates that data can be obtained via ftp.
+indicates that data can be obtained via FTP.
 .
-The first argument is the url and the second is the browser text.
+The first argument is the URL and the second is the browser text.
 .
 A third argument, similar to the macros above, is intended for stuff
 printed immediately afterwards.
@@ -288,17 +288,17 @@ The second and the third parameter are optional.
 Hyphenation is disabled while printing the actual URL.
 .
 As an example, here the location of the
-.FTP ftp://\:ftp.gnu.org/ "GNU ftp server" .
+.FTP ftp://\:ftp.gnu.org/ "GNU FTP server" .
 .
 The macro example above was specified by:
 .RS
 .IP
-.B .FTP ftp://\[rs]:ftp.gnu.org/ \[dq]GNU ftp server\[dq] .
+.B .FTP ftp://\[rs]:ftp.gnu.org/ \[dq]GNU FTP server\[dq] .
 .RE
 .
 .TP
 .B .TAG name
-Generates an html name tag from its argument.
+Generates an HTML name tag from its argument.
 .
 This can then be referenced using the
 .URL #URL URL
@@ -344,9 +344,9 @@ If the width is absent it defaults to 1\~inch.
 .
 If the height is absent it defaults to the width.
 .
-This maps onto an html img tag.
+This maps onto an HTML img tag.
 .
-If you are including a png image then it is advisable to use the
+If you are including a PNG image then it is advisable to use the
 .B PIMG
 macro.
 .
@@ -356,7 +356,7 @@ Include an image in PNG format.
 .
 This macro takes exactly the same parameters as the
 .B IMG
-macro; it has the advantage of working with PostScript and html devices
+macro; it has the advantage of working with PostScript and HTML devices
 also since it can automatically convert the image into the EPS format,
 using the following programs of the
 .B netpbm
@@ -544,7 +544,7 @@ Example:
 .
 .TP
 .B .HTML
-All text after this macro is treated as raw html.
+All text after this macro is treated as raw HTML.
 .
 If the document is processed without
 .B \-Thtml
@@ -629,7 +629,7 @@ This should be called at the end of the document if \&.ALN 
was used.
 .
 .TP
 .B ".LINKSTYLE color [ fontstyle [ openglyph closeglyph ] ]"
-Initialize default url attributes to be used if this macro set is not
+Initialize default URL attributes to be used if this macro set is not
 used with the HTML device.
 .
 The macro set initializes itself with the following call
@@ -653,7 +653,7 @@ but these values will be superseded by a user call to 
LINKSTYLE.
 By default
 .B \%grohtml
 generates links to all section headings and places these at the top of the
-html document.
+HTML document.
 .
 (See
 .URL #LK LINKS