summaryrefslogtreecommitdiff
path: root/tmac/groff_www.7.man
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2021-05-22 16:55:24 +1000
committerG. Branden Robinson <g.branden.robinson@gmail.com>2021-05-22 16:55:24 +1000
commit4ab064b69782f5e5b473e42b52f1635e06671cc6 (patch)
tree93905e3968ecab97d2e4a6f67894d836dc80e123 /tmac/groff_www.7.man
parent3533498a1effa5346630438d947182d754fb4e04 (diff)
downloadgroff-git-4ab064b69782f5e5b473e42b52f1635e06671cc6.tar.gz
groff_www(7): Stop using the "www" macro package.
* tmac/groff_www.7.man: Stop using the "www" macro package. The macros it exposes are not part of the quasi-standardized man(7) language, and thus should not be used in man(7) documents. See groff_man_style(7) for portability advice. Besides, the extension macros in the permissively-licensed an-ext.tmac are sufficient to support URL and email hyperlinks, and our SH and SS macro implementations already support anchor placement without requiring explicit effort from page authors. (initialization): Stop sourcing www.tmac. Stop calling .LK and .HR; the page-internal navigation links were being placed after the apropos line instead of at the beginning of the page, contradicting the comment that was there (possibly a bug). (Requests) <URL, LK>: Stop calling .TAG. <LK>: Drop paragraph advising reader to format page for groff's HTML output device to observe the naviagtion links at that point in the test. Also: * Break input lines at commas. * Use Oxford comma.
Diffstat (limited to 'tmac/groff_www.7.man')
-rw-r--r--tmac/groff_www.7.man23
1 files changed, 3 insertions, 20 deletions
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index 29b7e4ef4..ac6af707b 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -29,15 +29,6 @@ groff_www \- GNU roff macros for authoring web pages
.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr *groff_groff_www_7_man_C \n[.cp]
.cp 0
-.do mso www.tmac
-.
-.
-.\" we need the .LK here as we use it in the middle as an example --
-.\" once the user requests .LK then the automatic generation of links
-.\" at the top of the document is suppressed.
-.LK
-.
-.HR
.
.
.\" ====================================================================
@@ -202,9 +193,9 @@ the only parameter to this macro is the background image file.
.
.TP
.B .URL url [description] [after]
-generates
-.TAG URL
-a URL using either one, two or three arguments.
+generates a URL using either one,
+two,
+or three arguments.
.
The first parameter is the actual URL, the second is the name of the
link, and the third is optional stuff to be printed immediately
@@ -510,18 +501,10 @@ End heading.
.
.TP
.B .LK
-.TAG LK
Force
.I \%grohtml
to place the automatically generated links at this position.
.
-If this manual page has been processed with
-.B \-Thtml
-or
-.B \-Txhtml
-those links can be seen right here.
-.
-.LK
.
.TP
.B .HR