[groff] 01/01: roff.7, groff_filenames.7: add and repair about heirloom

[Bernd Warken]

bwarken pushed a commit to branch master
in repository groff.

commit 1230ace9812c554d0d8b0e2ea45bf7611669bf7b
Author: Bernd Warken <address@hidden>
Date:   Sat Aug 30 15:36:29 2014 +0200

    roff.7, groff_filenames.7: add and repair about heirloom
---
 ChangeLog                                   |    4 ++
 contrib/groff_filenames/ChangeLog           |    5 ++
 contrib/groff_filenames/groff_filenames.man |   57 +++++++++++++++++++++-----
 man/roff.man                                |   20 +++++++--
 4 files changed, 70 insertions(+), 16 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 9a4bd7f..4535820 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2014-08-30  Bernd Warken  <address@hidden>
+
+       * man/roff.man (roff.7): Repair documentation of heirloom.
+
 2014-08-28  Bernd Warken  <address@hidden>
 
        * src/roff/grog/grog.pl, src/roff/grog/subs.pl: Add `gpinyin'.
diff --git a/contrib/groff_filenames/ChangeLog 
b/contrib/groff_filenames/ChangeLog
index 1b220f3..d5ef7ab 100644
--- a/contrib/groff_filenames/ChangeLog
+++ b/contrib/groff_filenames/ChangeLog
@@ -1,3 +1,8 @@
+2014-08-30  Bernd Warken  <address@hidden>
+
+       * groff_filenames.man: Add extension `.1b' for `heirloom'
+       man-pages.
+
 2014-07-06  Bernd Warken  <address@hidden>
 
        * groff_filenames.man: Make it compatible to doclifter.
diff --git a/contrib/groff_filenames/groff_filenames.man 
b/contrib/groff_filenames/groff_filenames.man
index fe588b7..4fd2dab 100644
--- a/contrib/groff_filenames/groff_filenames.man
+++ b/contrib/groff_filenames/groff_filenames.man
@@ -295,28 +295,36 @@ package.
 .TP
 .IB <name> .man
 .I traditional
-Unix\-like man\-page format.
+Unix\-like man\-page format within groff source files.
+.
+.
+.TP
+.IB <name> .n
+A temporary man-page file produced from a
+.IB name .man
+man\-page by a run of
+.B make
+within the
+.B groff
+source package.
 .
 .
 .TP
 .IB <name> .mdoc
-additional BSD man-page format.
+Man-page format in BSD.
 .
 .
 .TP
-.IB <name> .mandoc
-Files using this extension recognize both man\-page formats in
-.B groff
-and other processors.
+.IB <name> .1b
+Man-page format in
+.IR "heirloom roff ".
 .
 .
 .TP
-.IB <name> .n
-A temporary man-page file produced by a run of
-.B make
-in the
+.IB <name> .mandoc
+Files using this extension recognize both man\-page formats in
 .B groff
-source package.
+and other processors.
 .
 .
 .\" --------------------------------------------------------------------
@@ -605,6 +613,33 @@ History and future
 .BR xz (@MAN1EXT@)
 .
 .
+.P
+A man-page of the naming form
+.IB name ( n )
+can be read in text mode by
+.RS
+.EX
+.BI man " n name"
+.EE
+.RE
+or in graphical mode (PDF) by
+.RS
+.EX
+.BI groffer " n name"
+.EE
+.RE
+.
+.
+.P
+.UR http://heirloom.sourceforge.net/
+Heirloom documentation
+.UE
+.
+.UR http://heirloom.cvs.sourceforge.net/heirloom/
+Heirloom download
+.UE
+.
+.
 .\" --------------------------------------------------------------------
 .SH "AUTHORS"
 .\" --------------------------------------------------------------------
diff --git a/man/roff.man b/man/roff.man
index 8706d94..21e0942 100644
--- a/man/roff.man
+++ b/man/roff.man
@@ -353,7 +353,7 @@ cf.\& section
 .
 .
 .\" --------------------------------------------------------------------
-.SS "Free roff"
+.SS "groff \[em] free GNU roff"
 .\" --------------------------------------------------------------------
 .
 The most important free
@@ -387,8 +387,8 @@ but many extensions were added.
 .
 It is the first
 .I roff
-system that is available on almost all operating systems \[en] and it is
-free.
+system that is available on almost all operating systems \[em] and it
+is free.
 .
 This makes
 .I groff
@@ -396,10 +396,14 @@ the de-facto
 .I roff
 standard today.
 .
-.P
+.
+.\" --------------------------------------------------------------------
+.SS "Free Heirloom roff"
+.\" --------------------------------------------------------------------
+.
 An alternative is
 .IR "Gunnar Ritter" 's
-.UR http://\:heirloom.sf.net
+.UR http://heirloom.sourceforge.net
 Heirloom Documentation Tools
 .UE
 project, started in 2005, which provides enhanced versions of the various
@@ -407,6 +411,12 @@ roff tools found in the OpenSolaris and Plan\~9 operating 
systems, now
 available under free licenses.
 .
 .
+.P
+The download page is
+.UR http://heirloom.cvs.sourceforge.net/heirloom
+.UE .
+.
+.
 .\" --------------------------------------------------------------------
 .SH "USING ROFF"
 .\" --------------------------------------------------------------------