From MAILER-DAEMON Thu Jan 02 03:55:42 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Vye46-0003c9-QP
	for mharc-groff-commit@gnu.org; Thu, 02 Jan 2014 03:55:42 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:38860)
	by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1Vye44-0003ZN-MF
	for groff-commit@gnu.org; Thu, 02 Jan 2014 03:55:41 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <wl@gnu.org>) id 1Vye42-0001sS-OH
	for groff-commit@gnu.org; Thu, 02 Jan 2014 03:55:40 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:57222)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1Vye42-0001sM-L6
	for groff-commit@gnu.org; Thu, 02 Jan 2014 03:55:38 -0500
Received: from wl by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <wl@gnu.org>) id 1Vye41-0005OF-Qx
	for groff-commit@gnu.org; Thu, 02 Jan 2014 08:55:38 +0000
Date: Thu, 02 Jan 2014 08:55:38 +0000
Message-Id: <E1Vye41-0005OF-Qx@vcs.savannah.gnu.org>
From: "Werner Lemberg" <wl@gnu.org>
To: groff-commit@gnu.org
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: 1f7060e0526fa80ce0fac41b3396ca8fc5641ae7
X-Git-Newrev: d5951b551a3cb8f9cbbf1458489bcbfefd390d83
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
Subject: [Groff-commit] GNU troff branch, master,
	updated. d5951b551a3cb8f9cbbf1458489bcbfefd390d83
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 02 Jan 2014 08:55:42 -0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU troff".

http://git.sv.gnu.org/gitweb/?p=groff.git;a=commitdiff;h=d5951b551a3cb8f9cbbf1458489bcbfefd390d83

The branch, master has been updated
       via  d5951b551a3cb8f9cbbf1458489bcbfefd390d83 (commit)
      from  1f7060e0526fa80ce0fac41b3396ca8fc5641ae7 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit d5951b551a3cb8f9cbbf1458489bcbfefd390d83
Author: Ralph Graulich <maillist@shauny.de>
Date:   Thu Jan 2 09:55:16 2014 +0100

    Typo.

-----------------------------------------------------------------------

Summary of changes:
 doc/groff.texinfo |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/doc/groff.texinfo b/doc/groff.texinfo
index 99cdb4d..55a22da 100644
--- a/doc/groff.texinfo
+++ b/doc/groff.texinfo
@@ -971,7 +971,7 @@ The command line format for @code{groff} is:
 groff [ -abceghijklpstvzCEGNRSUVXZ ] [ -d@var{cs} ] [ -D@var{arg} ]
       [ -f@var{fam} ] [ -F@var{dir} ] [ -I@var{dir} ] [ -K@var{arg} ]
       [ -L@var{arg} ] [ -m@var{name} ] [ -M@var{dir} ] [ -n@var{num} ]
-      [ -o@var{list} ] [ -P@var{arg} ] [ -r@var{cn} ] [ -T@var{def} ]
+      [ -o@var{list} ] [ -P@var{arg} ] [ -r@var{cn} ] [ -T@var{dev} ]
       [ -w@var{name} ] [ -W@var{name} ] [ @var{files}@dots{} ]
 @endExample
 


hooks/post-receive
-- 
GNU troff


From MAILER-DAEMON Thu Jan 02 09:16:03 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Vyj46-0008VJ-Vh
	for mharc-groff-commit@gnu.org; Thu, 02 Jan 2014 09:16:02 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:33848)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <cjwatson@debian.org>) id 1Vyixd-0005Op-Da
	for groff-commit@gnu.org; Thu, 02 Jan 2014 09:09:23 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <cjwatson@debian.org>) id 1VyixZ-0000sc-RL
	for groff-commit@gnu.org; Thu, 02 Jan 2014 09:09:21 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:33042)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <cjwatson@debian.org>) id 1VyixZ-0000sY-No
	for groff-commit@gnu.org; Thu, 02 Jan 2014 09:09:17 -0500
Received: from cjwatson by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <cjwatson@debian.org>) id 1VyixX-0003mh-TI
	for groff-commit@gnu.org; Thu, 02 Jan 2014 14:09:17 +0000
Date: Thu, 02 Jan 2014 14:09:16 +0000
Message-Id: <E1VyixX-0003mh-TI@vcs.savannah.gnu.org>
From: "Colin Watson" <cjwatson@debian.org>
To: groff-commit@gnu.org
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: d5951b551a3cb8f9cbbf1458489bcbfefd390d83
X-Git-Newrev: bd60d043a586f879b2194be3accf4e0fafdff23f
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
X-Mailman-Approved-At: Thu, 02 Jan 2014 09:16:01 -0500
Subject: [Groff-commit] GNU troff branch, master,
	updated. bd60d043a586f879b2194be3accf4e0fafdff23f
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 02 Jan 2014 14:09:23 -0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU troff".

http://git.sv.gnu.org/gitweb/?p=groff.git;a=commitdiff;h=bd60d043a586f879b2194be3accf4e0fafdff23f

The branch, master has been updated
       via  bd60d043a586f879b2194be3accf4e0fafdff23f (commit)
      from  d5951b551a3cb8f9cbbf1458489bcbfefd390d83 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit bd60d043a586f879b2194be3accf4e0fafdff23f
Author: Colin Watson <cjwatson@debian.org>
Date:   Thu Jan 2 13:38:30 2014 +0000

    '+' isn't a regex metacharacter in sed by default
    
    Based on an old patch from Fumitoshi UKAI <ukai@debian.or.jp>.
    
    * font/devascii/Makefile.sub ($(FONTS)): Convert extended regex
    syntax to basic for sed.
    * font/devcp1047/Makefile.sub ($(FONTS)): Likewise.
    * font/devhtml/Makefile.sub ($(FONTS)): Likewise.
    * font/devlatin1/Makefile.sub ($(FONTS)): Likewise.
    * font/devutf8/Makefile.sub ($(FONTS)): Likewise.

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog                   |    9 +++++++++
 font/devascii/Makefile.sub  |    4 ++--
 font/devcp1047/Makefile.sub |    4 ++--
 font/devhtml/Makefile.sub   |    4 ++--
 font/devlatin1/Makefile.sub |    4 ++--
 font/devutf8/Makefile.sub   |    4 ++--
 6 files changed, 19 insertions(+), 10 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index abf7534..465105a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2014-01-02  Colin Watson  <cjwatson@debian.org>
+
+	* font/devascii/Makefile.sub ($(FONTS)): Convert extended regex
+	syntax to basic for sed.
+	* font/devcp1047/Makefile.sub ($(FONTS)): Likewise.
+	* font/devhtml/Makefile.sub ($(FONTS)): Likewise.
+	* font/devlatin1/Makefile.sub ($(FONTS)): Likewise.
+	* font/devutf8/Makefile.sub ($(FONTS)): Likewise.
+
 2013-12-23  Bernd Warken  <groff-bernd.warken-72@web.de>
 
 	groff/src/roff/groff/groff.cpp: add groff option `-G' to the
diff --git a/font/devascii/Makefile.sub b/font/devascii/Makefile.sub
index 43b2b46..0fa2e77 100644
--- a/font/devascii/Makefile.sub
+++ b/font/devascii/Makefile.sub
@@ -12,8 +12,8 @@ $(FONTS): R.proto
 	@-rm -f $@
 	@(charwidth=`expr $(RES) / $(CPI)` ; \
  	 sed -e "s/^name [A-Z]*$$/name $@/" \
-	     -e "s/^\\([^	]*\\)	[0-9]+	/\\1	$$charwidth	/" \
-	     -e "s/^spacewidth [0-9]+$$/spacewidth $$charwidth/" \
+	     -e "s/^\\([^	]*\\)	[0-9][0-9]*	/\\1	$$charwidth	/" \
+	     -e "s/^spacewidth [0-9][0-9]*$$/spacewidth $$charwidth/" \
 	     -e "s/^internalname .*$$/internalname $@/" \
 	     -e "/^internalname/s/BI/3/" \
 	     -e "/^internalname/s/B/2/" \
diff --git a/font/devcp1047/Makefile.sub b/font/devcp1047/Makefile.sub
index 4c2d1db..5aa6cff 100644
--- a/font/devcp1047/Makefile.sub
+++ b/font/devcp1047/Makefile.sub
@@ -12,8 +12,8 @@ $(FONTS): R.proto
 	@-rm -f $@
 	@(charwidth=`expr $(RES) / $(CPI)` ; \
  	 sed -e "s/^name [A-Z]*$$/name $@/" \
-	     -e "s/^\\([^	]*\\)	[0-9]+	/\\1	$$charwidth	/" \
-	     -e "s/^spacewidth [0-9]+$$/spacewidth $$charwidth/" \
+	     -e "s/^\\([^	]*\\)	[0-9][0-9]*	/\\1	$$charwidth	/" \
+	     -e "s/^spacewidth [0-9][0-9]*$$/spacewidth $$charwidth/" \
 	     -e "s/^internalname .*$$/internalname $@/" \
 	     -e "/^internalname/s/BI/3/" \
 	     -e "/^internalname/s/B/2/" \
diff --git a/font/devhtml/Makefile.sub b/font/devhtml/Makefile.sub
index c1e5525..36fcf77 100644
--- a/font/devhtml/Makefile.sub
+++ b/font/devhtml/Makefile.sub
@@ -13,8 +13,8 @@ $(FONTS): R.proto
 	@-rm -f $@
 	@(charwidth=`expr $(RES) / $(CPI)` ; \
  	 sed -e "s/^name [A-Z]*$$/name $@/" \
-	     -e "s/^\\([^	]*\\)	[0-9]+	/\\1	$$charwidth	/" \
-	     -e "s/^spacewidth [0-9]+$$/spacewidth $$charwidth/" \
+	     -e "s/^\\([^	]*\\)	[0-9][0-9]*	/\\1	$$charwidth	/" \
+	     -e "s/^spacewidth [0-9][0-9]*$$/spacewidth $$charwidth/" \
 	     -e "s/^internalname .*$$/internalname $@/" \
 	     -e "/^internalname/s/CR/4/" \
 	     -e "/^internalname/s/BI/3/" \
diff --git a/font/devlatin1/Makefile.sub b/font/devlatin1/Makefile.sub
index 127e02c..b261f57 100644
--- a/font/devlatin1/Makefile.sub
+++ b/font/devlatin1/Makefile.sub
@@ -12,8 +12,8 @@ $(FONTS): R.proto
 	@-rm -f $@
 	@(charwidth=`expr $(RES) / $(CPI)` ; \
  	 sed -e "s/^name [A-Z]*$$/name $@/" \
-	     -e "s/^\\([^	]*\\)	[0-9]+	/\\1	$$charwidth	/" \
-	     -e "s/^spacewidth [0-9]+$$/spacewidth $$charwidth/" \
+	     -e "s/^\\([^	]*\\)	[0-9][0-9]*	/\\1	$$charwidth	/" \
+	     -e "s/^spacewidth [0-9][0-9]*$$/spacewidth $$charwidth/" \
 	     -e "s/^internalname .*$$/internalname $@/" \
 	     -e "/^internalname/s/BI/3/" \
 	     -e "/^internalname/s/B/2/" \
diff --git a/font/devutf8/Makefile.sub b/font/devutf8/Makefile.sub
index 221bd3f..1047bdc 100644
--- a/font/devutf8/Makefile.sub
+++ b/font/devutf8/Makefile.sub
@@ -12,8 +12,8 @@ $(FONTS): R.proto
 	@-rm -f $@
 	@(charwidth=`expr $(RES) / $(CPI)` ; \
  	 sed -e "s/^name [A-Z]*$$/name $@/" \
-	     -e "s/^\\([^	]*\\)	[0-9]+	/\\1	$$charwidth	/" \
-	     -e "s/^spacewidth [0-9]+$$/spacewidth $$charwidth/" \
+	     -e "s/^\\([^	]*\\)	[0-9][0-9]*	/\\1	$$charwidth	/" \
+	     -e "s/^spacewidth [0-9][0-9]*$$/spacewidth $$charwidth/" \
 	     -e "s/^internalname .*$$/internalname $@/" \
 	     -e "/^internalname/s/BI/3/" \
 	     -e "/^internalname/s/B/2/" \


hooks/post-receive
-- 
GNU troff


From MAILER-DAEMON Thu Jan 02 11:02:12 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1Vykiq-0001PK-Tz
	for mharc-groff-commit@gnu.org; Thu, 02 Jan 2014 11:02:12 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54977)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1Vykgd-0000G3-5s
	for groff-commit@gnu.org; Thu, 02 Jan 2014 10:59:56 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1VykgX-0006ql-Ra
	for groff-commit@gnu.org; Thu, 02 Jan 2014 10:59:55 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:34640)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1VykgX-0006qh-OA
	for groff-commit@gnu.org; Thu, 02 Jan 2014 10:59:49 -0500
Received: from deri by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <deri@chuzzlewit.myzen.co.uk>) id 1VykgW-0003a0-K8
	for groff-commit@gnu.org; Thu, 02 Jan 2014 15:59:49 +0000
Date: Thu, 02 Jan 2014 15:59:48 +0000
Message-Id: <E1VykgW-0003a0-K8@vcs.savannah.gnu.org>
From: "Deri James" <deri@chuzzlewit.myzen.co.uk>
To: groff-commit@gnu.org
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: bd60d043a586f879b2194be3accf4e0fafdff23f
X-Git-Newrev: 3949425d5304d86e740ec0019b2bcc1131a549fb
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
X-Mailman-Approved-At: Thu, 02 Jan 2014 11:02:11 -0500
Subject: [Groff-commit] GNU troff branch, master,
	updated. 3949425d5304d86e740ec0019b2bcc1131a549fb
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Thu, 02 Jan 2014 15:59:56 -0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU troff".

http://git.sv.gnu.org/gitweb/?p=groff.git;a=commitdiff;h=3949425d5304d86e740ec0019b2bcc1131a549fb

The branch, master has been updated
       via  3949425d5304d86e740ec0019b2bcc1131a549fb (commit)
      from  bd60d043a586f879b2194be3accf4e0fafdff23f (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 3949425d5304d86e740ec0019b2bcc1131a549fb
Author: Deri James <deri@chuzzlewit.myzen.co.uk>
Date:   Thu Jan 2 15:46:21 2014 +0000

    pdfmom can now be used as a command pipe, gropdf
    handles preconv output

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog                    |   10 ++++++
 src/devices/gropdf/gropdf.pl |    5 ++-
 src/devices/gropdf/pdfmom.pl |   69 ++++++++++++++++++++++++++++++++++++++---
 tmac/pdf.tmac                |    9 ++++-
 4 files changed, 85 insertions(+), 8 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 465105a..11d45d3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2013-01-02  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	* src/devices/gropdf/gropdf.pl: gropdf use to fail when handling
+	  output from preconv, now works.
+
+	* src/devices/gropdf/pdfmom.pl: can now be used as a pipeline, and 
+	  improvements made to its switch handling and use with preconv.
+
+	* tmac/pdf.tmac: changes to support preconv.
+
 2014-01-02  Colin Watson  <cjwatson@debian.org>
 
 	* font/devascii/Makefile.sub ($(FONTS)): Convert extended regex
diff --git a/src/devices/gropdf/gropdf.pl b/src/devices/gropdf/gropdf.pl
index 92b3787..f18bac8 100644
--- a/src/devices/gropdf/gropdf.pl
+++ b/src/devices/gropdf/gropdf.pl
@@ -711,6 +711,7 @@ sub do_x
 	    {
 		my $pdfmark=$1;
 		$pdfmark=~s((\d{4,6}) u)(sprintf("%.1f",$1/$desc{sizescale}))eg;
+		$pdfmark=~s(\\\[u00(..)\])(chr(hex($1)))eg;
 
 		if ($pdfmark=~m/(.+) \/DOCINFO/)
 		{
@@ -1125,6 +1126,7 @@ sub PutHotSpot
     $l=~s/Color/C/;
     $l=~s/Action/A/;
     $l=~s'/Subtype /URI'/S /URI';
+    $l=~s(\\\[u00(..)\])(chr(hex($1)))eg;
     my @xwds=split(' ',"<< $l >>");
     my $annotno=BuildObj(++$objct,ParsePDFValue(\@xwds));
     my $annot=$obj[$objct];
@@ -1622,7 +1624,7 @@ sub nextwd
 
     return('') if !defined($wd);
 
-    if ($wd=~m/^(.*?)(<<|>>|\[|\])(.*)/)
+    if ($wd=~m/^(.*?)(<<|>>|(?:(?<!\\)\[|\]))(.*)/)
     {
 	if (defined($1) and length($1))
 	{
@@ -2326,6 +2328,7 @@ sub do_p
     $cpage=$obj[$cpageno]->{DATA};
     $pages->{'Count'}++;
     $stream="q 1 0 0 1 0 0 cm\n$linejoin J\n$linecap j\n";
+    $stream.=$strkcol."\n", $curstrk=$strkcol if $strkcol ne '';
     $mode='g';
     $curfill='';
 #    @mediabox=@defaultmb;
diff --git a/src/devices/gropdf/pdfmom.pl b/src/devices/gropdf/pdfmom.pl
index c2bb297..c9c8e58 100644
--- a/src/devices/gropdf/pdfmom.pl
+++ b/src/devices/gropdf/pdfmom.pl
@@ -24,13 +24,19 @@
 # along with this program. If not, see <http://www.gnu.org/licenses/>.
 
 use strict;
+use File::Temp qw/tempfile/;
 my @cmd;
 my $dev='pdf';
+my $preconv='';
+my $readstdin=1;
 
 $ENV{PATH}=$ENV{GROFF_BIN_PATH}.':'.$ENV{PATH} if exists($ENV{GROFF_BIN_PATH});
+$ENV{TMPDIR}=$ENV{GROFF_TMPDIR} if exists($ENV{GROFF_TMPDIR});
 
 while (my $c=shift)
 {
+    $c=~s/(?<!\\)"/\\"/g;
+    
     if (substr($c,0,2) eq '-T')
     {
 	if (length($c) > 2)
@@ -41,7 +47,24 @@ while (my $c=shift)
 	{
 	    $dev=shift;
 	}
-
+	next;
+    }
+    elsif (substr($c,0,2) eq '-K')
+    {
+	if (length($c) > 2)
+	{
+	    $preconv=$c;
+	}
+	else
+	{
+	    $preconv=$c;
+	    $preconv.=shift;
+	}
+	next;
+    }
+    elsif (substr($c,0,2) eq '-k')
+    {
+	$preconv=$c;
 	next;
     }
     elsif ($c eq '-z' or $c eq '-Z')
@@ -49,21 +72,57 @@ while (my $c=shift)
 	$dev=$c;
 	next;
     }
-
     elsif ($c eq '-v')
     {
 	print "GNU pdfmom (groff) version @VERSION@\n";
 	exit;
     }
+    elsif (substr($c,0,1) eq '-')
+    {
+	if (length($c) > 1)
+	{
+	    push(@cmd,"\"$c\"");
+	    push(@cmd,"'".shift."'") if length($c)==2 and index('dDfFIKLmMnoPrwW',substr($c,-1)) >= 0;
+	}
+	else
+	{
+	    # Just a '-'
+	    
+	    push(@cmd,$c);
+	    $readstdin=2;
+	}
+    }
+    else
+    {
+	# Got a filename?
+	
+	push(@cmd,"\"$c\"");
+	$readstdin=0 if $readstdin == 1;
+	
+    }
 
-    push(@cmd,$c);
 }
 
-my $cmdstring=join(' ',@cmd);
+my $cmdstring=' '.join(' ',@cmd).' ';
+
+if ($readstdin)
+{
+    my ($fh,$tmpfn)=tempfile('pdfmom-XXXXX', UNLINK=>1);
+
+    while (<STDIN>)
+    {
+	print $fh ($_);
+    }
+    
+    close($fh);
+    
+    $cmdstring=~s/ - / $tmpfn / if $readstdin == 2;
+    $cmdstring.=" $tmpfn " if $readstdin == 1;
+}
 
 if ($dev eq 'pdf')
 {
-    system("groff -Tpdf -dPDF.EXPORT=1 -mom -z $cmdstring 2>&1 | grep '^.ds' | groff -Tpdf -mom - $cmdstring");
+    system("groff -Tpdf -dPDF.EXPORT=1 -mom -z $cmdstring 2>&1 | grep '^.ds' | groff -Tpdf -mom - $preconv $cmdstring");
 }
 elsif ($dev eq 'ps')
 {
diff --git a/tmac/pdf.tmac b/tmac/pdf.tmac
index 04d1c52..8867823 100644
--- a/tmac/pdf.tmac
+++ b/tmac/pdf.tmac
@@ -574,7 +574,10 @@ am solely responsible for any bugs I may have introduced into this file.
 .\" if any, and set the marker -- if we still can't identify the name
 .\" for the destination, then this marker will not be created.
 .\"
-.pdf*href.set \\*[pdf:href-N] \\*[pdf:href-D] \\$1
+.ds PDFBOOKMARK.NAME "\\*[pdf:href-N]\\*[pdf:href-D]
+.pdf*href.set \\*[PDFBOOKMARK.NAME] \\$1
+.ds pdf:look(\\*[PDFBOOKMARK.NAME]) \\$*
+.if dPDF.EXPORT .tm .ds pdf:look(\\*[PDFBOOKMARK.NAME]) \\$*
 .\"
 .\"
 .\" Irrespective of whether this marker is created, or not,
@@ -702,7 +705,9 @@ am solely responsible for any bugs I may have introduced into this file.
 .   \"
 \#.   if dPDFHREF.COLOUR .defcolor pdf:href.colour rgb \\*[PDFHREF.COLOUR]
 .   nr pdf:bm.width \\w'\\*[PDFHREF.DESC]'
-.   nop \&\m[\\*[PDFHREF.TEXT.COLOUR]]\X'pdf: markstart \\n[rst] \\n[rsb] \\n[PDFHREF.LEADING] \\*[pdf:href.link]'\\*[PDFHREF.DESC]\X'pdf: markend'\m[]\c
+.   nop \&\m[\\*[PDFHREF.TEXT.COLOUR]]\c
+.   device pdf: markstart \\n[rst] \\n[rsb] \\n[PDFHREF.LEADING] \\*[pdf:href.link]
+.   nop \&\\*[PDFHREF.DESC]\X'pdf: markend'\m[]\c
 .   \"
 .   \" Clean up the temporary registers and strings, used to
 .   \" compute the "hot-spot" bounds, and format the reference,


hooks/post-receive
-- 
GNU troff


From MAILER-DAEMON Sat Jan 04 14:23:53 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1VzWp7-0001HA-G9
	for mharc-groff-commit@gnu.org; Sat, 04 Jan 2014 14:23:53 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:44466)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VzWp1-0001GH-6M
	for groff-commit@gnu.org; Sat, 04 Jan 2014 14:23:50 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VzWox-0006WB-JH
	for groff-commit@gnu.org; Sat, 04 Jan 2014 14:23:47 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:45696)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VzWox-0006W6-EF
	for groff-commit@gnu.org; Sat, 04 Jan 2014 14:23:43 -0500
Received: from bwarken by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VzWow-00047q-71
	for groff-commit@gnu.org; Sat, 04 Jan 2014 19:23:43 +0000
Date: Sat, 04 Jan 2014 19:23:42 +0000
Message-Id: <E1VzWow-00047q-71@vcs.savannah.gnu.org>
From: "Bernd Warken" <groff-bernd.warken-72@web.de>
To: groff-commit@gnu.org
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: 3949425d5304d86e740ec0019b2bcc1131a549fb
X-Git-Newrev: 309660d6de892de92c9b4b89c160cb4e4606736b
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
Subject: [Groff-commit] GNU troff branch, master,
	updated. 309660d6de892de92c9b4b89c160cb4e4606736b
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sat, 04 Jan 2014 19:23:51 -0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU troff".

http://git.sv.gnu.org/gitweb/?p=groff.git;a=commitdiff;h=309660d6de892de92c9b4b89c160cb4e4606736b

The branch, master has been updated
       via  309660d6de892de92c9b4b89c160cb4e4606736b (commit)
      from  3949425d5304d86e740ec0019b2bcc1131a549fb (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 309660d6de892de92c9b4b89c160cb4e4606736b
Author: Bernd Warken <groff-bernd.warken-72@web.de>
Date:   Sat Jan 4 20:21:05 2014 +0100

    Add request .FONT to an-ext.tmac.
    Put under GPL2 and reorder groff_man.man.

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog          |   13 +-
 tmac/an-ext.tmac   |   20 ++
 tmac/groff_man.man |  700 +++++++++++++++++++++++++++++-----------------------
 3 files changed, 421 insertions(+), 312 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 11d45d3..05f74ab 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,10 +1,17 @@
+2013-12-23  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* groff/tmac/an-ext.tmac: add new request .FONT for using
+	different font names on a single line.
+
+	* groff/tmac/groff_man.man: put under GPL2, reordered and enhanced.
+
 2013-01-02  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
 	* src/devices/gropdf/gropdf.pl: gropdf use to fail when handling
-	  output from preconv, now works.
+	output from preconv, now works.
 
 	* src/devices/gropdf/pdfmom.pl: can now be used as a pipeline, and 
-	  improvements made to its switch handling and use with preconv.
+	improvements made to its switch handling and use with preconv.
 
 	* tmac/pdf.tmac: changes to support preconv.
 
@@ -19,7 +26,7 @@
 
 2013-12-23  Bernd Warken  <groff-bernd.warken-72@web.de>
 
-	groff/src/roff/groff/groff.cpp: add groff option `-G' to the
+	* groff/src/roff/groff/groff.cpp: add groff option `-G' to the
 	documentation in `synopsis()'.
 
 2013-12-06  Mike Frysinger  <vapier@gentoo.org>
diff --git a/tmac/an-ext.tmac b/tmac/an-ext.tmac
index 3816025..30f8c62 100644
--- a/tmac/an-ext.tmac
+++ b/tmac/an-ext.tmac
@@ -181,6 +181,26 @@
 ..
 .
 .
+.\" .FONT (<font name> <text> [<font name> <text> ...])
+.\" Print in different fonts, e.g. using the font names R, I, B, CR, CI, CB
+.de FONT
+.  if (\\n[.$] = 0) \{\
+.       nop \&\f[P]\&
+.       return
+.  \}
+.  ds result \&
+.  while (\\n[.$] >= 2) \{\
+.       as result \,\f[\\$1]\\$2
+.       if !"\\$1"P" .as result \f[P]
+.       shift 2
+.  \}
+.  if (\\n[.$] = 1) .as result \,\f[\\$1]
+.  nh
+.  nop \\*[result]\&
+.  hy
+..
+.
+.
 .\" Start example.
 .de EX
 .  nr mE \\n(.f
diff --git a/tmac/groff_man.man b/tmac/groff_man.man
index e885294..b21e675 100644
--- a/tmac/groff_man.man
+++ b/tmac/groff_man.man
@@ -1,21 +1,25 @@
 .ig
-Copyright (C) 1999-2005, 2007-2009, 2011
-Free Software Foundation, Inc.
+Copyright (C) 1999-2005, 2007-2009, 2011, 2014
+  Free Software Foundation, Inc.
 
-Permission is granted to make and distribute verbatim copies of this
-manual provided the copyright notice and this permission notice are
-preserved on all copies.
+Last Update: 4 Jan 2014
 
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided that the
-entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
+This file is part of `GNU groff'.
 
-Permission is granted to copy and distribute translations of this
-manual into another language, under the above conditions for modified
-versions, except that this permission notice may be included in
-translations approved by the Free Software Foundation instead of in
-the original English.
+  `GNU groff' is free software: you can redistribute it and/or modify it
+under the terms of the `GNU General Public License' as published by the
+`Free Software Foundation', either version 2 of the License, or (at your
+option) any later version.
+
+  `GNU groff' is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the `GNU
+General Public License' for more details.
+
+  You should have received a copy of the 'GNU General Public License`
+along with `groff', see the files `COPYING' and `LICENSE' in the top
+directory of the `groff' source package.  If not, see
+<http://www.gnu.org/licenses/>.
 ..
 .
 .
@@ -23,14 +27,12 @@ the original English.
 .
 .
 .\" ----------------------------------------------------------------
-.
 .SH NAME
 .
 groff_man \- groff `man' macros to support generation of man pages
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH SYNOPSIS
 .
 .SY "groff\ \-man"
@@ -48,7 +50,6 @@ groff_man \- groff `man' macros to support generation of man pages
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH DESCRIPTION
 .
 The
@@ -64,7 +65,6 @@ package.
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH OPTIONS
 .
 The
@@ -72,6 +72,7 @@ The
 macros understand the following command line options (which define
 various registers).
 .
+.
 .TP
 .B \-rcR=1
 This option (the default if in nroff mode) creates a single, very
@@ -81,17 +82,20 @@ Say
 .B \-rcR=0
 to disable it.
 .
+.
 .TP
 .B \-rC1
 If more than one manual page is given on the command line, number the
 pages continuously, rather than starting each at\~1.
 .
+.
 .TP
 .B \-rD1
 Double-sided printing.
 .
 Footers for even and odd pages are formatted differently.
 .
+.
 .TP
 .BI \-rFT= dist
 Set distance of the footer relative to the bottom of the page if
@@ -99,6 +103,7 @@ negative or relative to the top if positive.
 .
 The default is -0.5i.
 .
+.
 .TP
 .BI \-rHY= flags
 Set hyphenation flags.
@@ -110,6 +115,7 @@ of a word.
 .
 These values are additive; the default is\~14.
 .
+.
 .TP
 .BI \-rIN= width
 Set body text indentation to
@@ -123,6 +129,7 @@ For
 this value should always be an integer multiple of unit `n' to get
 consistent indentation.
 .
+.
 .TP
 .BI \-rLL= line-length
 Set line length.
@@ -139,6 +146,7 @@ mode and 6.5i in
 .I troff
 mode.
 .
+.
 .IP
 Note that the use of a `.ll' request to initialize the line length
 is supported for backward compatibility with some versions of the
@@ -161,6 +169,7 @@ request preceding the use of the `TH' macro,
 .I does
 set a line length of 65n.
 .
+.
 .TP
 .BI \-rLT= title-length
 Set title length.
@@ -168,6 +177,7 @@ Set title length.
 If this option is not given, the title length defaults to the line
 length.
 .
+.
 .TP
 .BI \-rP nnn
 Enumeration of pages start with
@@ -182,12 +192,14 @@ points
 .RI ( xx
 can be 10, 11, or\~12) rather than 10\~points.
 .
+.
 .TP
 .BI \-rSN= width
 Set sub-subheading indentation to
 .IR width .
 The default is 3n.
 .
+.
 .TP
 .BI \-rX nnn
 After page\~\c
@@ -203,7 +215,6 @@ numbers: 1, 2, 2a, 2b, 2c, etc.
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH USAGE
 .
 This section describes the available macros for manual pages.
@@ -215,89 +226,39 @@ which is loaded immediately after the
 .B man
 package.
 .
-.TP
-.BI .TH " title section \fR[\fPextra1\fR]\fP \fR[\fPextra2\fR]\fP \fR[\fPextra3\fR]"
-Set the title of the
-.I man\~page
-to
-.I title
-and the section to
-.IR section ,
-which must take on a value between 1 and\~8.
-.
-The value
-.I section
-may also have a string appended, e.g. `.pm', to indicate a specific
-subsection of the
-.IR \%man\~pages .
-Both
-.I title
-and
-.I section
-are positioned at the left and right in the header line (with
-.I section
-in parentheses immediately appended to
-.IR title .
-.I extra1
-is positioned in the middle of the footer line.
-.I extra2
-is positioned at the left in the footer line (or at the left on
-even pages and at the right on odd pages if double-sided printing is
-active).
-.I extra3
-is centered in the header line.
-.
-.IP
-For HTML output, headers and footers are completely suppressed.
-.
-.IP
-Additionally, this macro starts a new page; the new line number is\~1
-again (except if the `-rC1' option is given on the command line) --
-this feature is intended only for formatting multiple
-.IR \%man\~pages ;
-a single
-.I \%man\~page
-should contain exactly one
-.B TH
-macro at the beginning of the file.
 .
 .TP
-.BI .SH " \fR[\fPtext for a heading\fR]\fP"
-Set up an unnumbered section heading sticking out to the left.
+.B .EX
+.TQ
+.B .EE
+Example/End Example.
 .
-Prints out all the text following
-.B SH
-up to the end of the line (or the text in the next input line if there
-is no argument to
-.BR SH )
-in bold face
-(or the font specified by the string
-.BR HF ),
-one size larger than the base document size.
+After
+.BR EX ,
+filling is disabled and the font is set to constant-width.
 .
-Additionally, the left margin and the indentation for the following
-text is reset to the default values.
+This is useful for formatting code, command, and
+configuration-file examples.
 .
-.TP
-.BI .SS " \fR[\fPtext for a heading\fR]\fP"
-Set up a secondary, unnumbered section heading.
+The
+.B EE
+macro restores filling and restores the previous font.
 .
-Prints out all the text following
-.B SS
-up to the end of the line (or the text in the next input line if there
-is no argument to
-.BR SS )
-in bold face
-(or the font specified by the string
-.BR HF ),
-at the same size as the base document size.
+.IP
+These macros are defined on many (but not all) legacy Unix systems
+running classic troff.
+.
+To be certain your page will be portable to those systems, copy
+their definitions from the
+.B \%an-ext.tmac
+file of a
+.BR groff
+installation.
 .
-Additionally, the left margin and the indentation for the following
-text is reset to the default values.
 .
 .TP
-.BI .TP " \fR[\fPnnn\fR]\fP"
-Set up an indented paragraph with label.
+.BI .HP " \fR[\fPnnn\fR]\fP"
+Set up a paragraph with hanging left indentation.
 .
 The indentation is set to
 .I nnn
@@ -309,70 +270,36 @@ or
 .B HP
 (or to the default value if none of them have been used yet).
 .
-.IP
-The first input line of text following this macro is interpreted as a
-string to be printed flush-left, as it is appropriate for a label.
-.
-It is not interpreted as part of a paragraph, so there is no attempt
-to fill the first line with text from the following input lines.
-.
-Nevertheless, if the label is not as wide as the indentation the
-paragraph starts at the same line (but indented), continuing on the
-following lines.
-.
-If the label is wider than the indentation the descriptive part of the
-paragraph begins on the line following the label, entirely indented.
-.
-Note that neither font shape nor font size of the label is set to a
-default value; on the other hand, the rest of the text has default
-font settings.
-.
-.IP
-The
-.B TP
-macro is the macro used for the explanations you are just reading.
+Font size and face are reset to its default values.
 .
-.TP
-.B .TQ
-The
-.B TQ
-macro sets up header continuation for a .TP macro.
+The following paragraph illustrates the effect of this macro with
+hanging indentation set to\~4 (enclosed by
+.B .RS
+and
+.B .RE
+to set the left margin temporarily to the current indentation):
 .
-With it, you can stack up any number of labels (such as in a
-glossary, or list of commands) before beginning the indented
-paragraph.
+.RS
+.HP 4
+This is a paragraph following an invocation of the
+.B HP
+macro.
 .
-For an example, look just past the next paragraph.
+As you can see, it produces a paragraph where all lines but the first
+are indented.
+.RE
 .
 .IP
-This macro is not defined on legacy Unix systems running classic
-troff.
-.
-To be certain your page will be portable to those systems,
-copy its definition from the
-.B \%an-ext.tmac
-file of a
-.BR groff
-installation.
-.
-.TP
-.B .LP
-.TQ
-.B .PP
-.TQ
-.B .P
-These macros are mutual aliases.
+Use of this presentation-level macro is deprecated.
 .
-Any of them causes a line break at the current position, followed by a
-vertical space downwards by the amount specified by the
-.B PD
-macro.
+While it is universally portable to legacy Unix systems, a hanging
+indentation cannot be expressed naturally under HTML, and many
+HTML-based manual viewers simply interpret it as a starter for a
+normal paragraph.
 .
-The font size and shape are reset to the default value (normally 10pt
-Roman).
+Thus, any information or distinction you tried to express with the
+indentation may be lost.
 .
-Finally, the current left margin and the indentation is reset to the
-default values.
 .
 .TP
 .BI .IP " \fR[\fPdesignator\fR]\fP \fR[\fPnnn\fR]\fP"
@@ -426,49 +353,41 @@ This macro produces an unindented label followed by an indented
 paragraph.
 .RE
 .
+.
 .TP
-.BI .HP " \fR[\fPnnn\fR]\fP"
-Set up a paragraph with hanging left indentation.
+.B .LP
+.TQ
+.B .PP
+.TQ
+.B .P
+These macros are mutual aliases.
 .
-The indentation is set to
-.I nnn
-if that argument is supplied (the default unit is `n' if omitted),
-otherwise it is set to the previous indentation value specified with
-.BR TP ,
-.BR IP ,
-or
-.B HP
-(or to the default value if none of them have been used yet).
+Any of them causes a line break at the current position, followed by a
+vertical space downwards by the amount specified by the
+.B PD
+macro.
 .
-Font size and face are reset to its default values.
+The font size and shape are reset to the default value (normally 10pt
+Roman).
 .
-The following paragraph illustrates the effect of this macro with
-hanging indentation set to\~4 (enclosed by
-.B .RS
-and
-.B .RE
-to set the left margin temporarily to the current indentation):
+Finally, the current left margin and the indentation is reset to the
+default values.
 .
-.RS
-.HP 4
-This is a paragraph following an invocation of the
-.B HP
-macro.
 .
-As you can see, it produces a paragraph where all lines but the first
-are indented.
+.TP
+.BI .RE " \fR[\fPnnn\fR]\fP"
+This macro moves the left margin back to level
+.IR nnn ,
+restoring the previous left margin.
 .
-.RE
-.IP
-Use of this presentation-level macro is deprecated.
+If no argument is given, it moves one level back.
 .
-While it is universally portable to legacy Unix systems, a hanging
-indentation cannot be expressed naturally under HTML, and many
-HTML-based manual viewers simply interpret it as a starter for a
-normal paragraph.
+The first level (i.e., no call to
+.B RS
+yet) has number\~1, and each call to
+.B RS
+increases the level by\~1.
 .
-Thus, any information or distinction you tried to express with the
-indentation may be lost.
 .
 .TP
 .BI .RS " \fR[\fPnnn\fR]\fP"
@@ -484,53 +403,158 @@ or
 .
 The indentation value is then set to the default.
 .
+.
 .IP
 Calls to the
 .B RS
 macro can be nested.
 .
+.
 .TP
-.BI .RE " \fR[\fPnnn\fR]\fP"
-This macro moves the left margin back to level
-.IR nnn ,
-restoring the previous left margin.
+.BI .SH " \fR[\fPtext for a heading\fR]\fP"
+Set up an unnumbered section heading sticking out to the left.
 .
-If no argument is given, it moves one level back.
+Prints out all the text following
+.B SH
+up to the end of the line (or the text in the next input line if there
+is no argument to
+.BR SH )
+in bold face
+(or the font specified by the string
+.BR HF ),
+one size larger than the base document size.
+.
+Additionally, the left margin and the indentation for the following
+text is reset to the default values.
 .
-The first level (i.e., no call to
-.B RS
-yet) has number\~1, and each call to
-.B RS
-increases the level by\~1.
 .
 .TP
-.B .EX
-.TQ
-.B .EE
-Example/End Example.
+.BI .SS " \fR[\fPtext for a heading\fR]\fP"
+Set up a secondary, unnumbered section heading.
 .
-After
-.BR EX ,
-filling is disabled and the font is set to constant-width.
+Prints out all the text following
+.B SS
+up to the end of the line (or the text in the next input line if there
+is no argument to
+.BR SS )
+in bold face
+(or the font specified by the string
+.BR HF ),
+at the same size as the base document size.
 .
-This is useful for formatting code, command, and
-configuration-file examples.
+Additionally, the left margin and the indentation for the following
+text is reset to the default values.
+.
+.
+.TP
+.BI .TH " title section \fR[\fPextra1\fR]\fP \fR[\fPextra2\fR]\fP \fR[\fPextra3\fR]"
+Set the title of the
+.I man\~page
+to
+.I title
+and the section to
+.IR section ,
+which must take on a value between 1 and\~8.
+.
+The value
+.I section
+may also have a string appended, e.g. `.pm', to indicate a specific
+subsection of the
+.IR \%man\~pages .
+Both
+.I title
+and
+.I section
+are positioned at the left and right in the header line (with
+.I section
+in parentheses immediately appended to
+.IR title .
+.I extra1
+is positioned in the middle of the footer line.
+.I extra2
+is positioned at the left in the footer line (or at the left on
+even pages and at the right on odd pages if double-sided printing is
+active).
+.I extra3
+is centered in the header line.
+.
+.IP
+For HTML output, headers and footers are completely suppressed.
+.
+.IP
+Additionally, this macro starts a new page; the new line number is\~1
+again (except if the `-rC1' option is given on the command line) --
+this feature is intended only for formatting multiple
+.IR \%man\~pages ;
+a single
+.I \%man\~page
+should contain exactly one
+.B TH
+macro at the beginning of the file.
 .
+.
+.TP
+.BI .TP " \fR[\fPnnn\fR]\fP"
+Set up an indented paragraph with label.
+.
+The indentation is set to
+.I nnn
+if that argument is supplied (the default unit is `n' if omitted),
+otherwise it is set to the previous indentation value specified with
+.BR TP ,
+.BR IP ,
+or
+.B HP
+(or to the default value if none of them have been used yet).
+.
+.IP
+The first input line of text following this macro is interpreted as a
+string to be printed flush-left, as it is appropriate for a label.
+.
+It is not interpreted as part of a paragraph, so there is no attempt
+to fill the first line with text from the following input lines.
+.
+Nevertheless, if the label is not as wide as the indentation the
+paragraph starts at the same line (but indented), continuing on the
+following lines.
+.
+If the label is wider than the indentation the descriptive part of the
+paragraph begins on the line following the label, entirely indented.
+.
+Note that neither font shape nor font size of the label is set to a
+default value; on the other hand, the rest of the text has default
+font settings.
+.
+.IP
 The
-.B EE
-macro restores filling and restores the previous font.
+.B TP
+macro is the macro used for the explanations you are just reading.
+.
+.
+.TP
+.B .TQ
+The
+.B TQ
+macro sets up header continuation for a .TP macro.
+.
+With it, you can stack up any number of labels (such as in a
+glossary, or list of commands) before beginning the indented
+paragraph.
+.
+For an example, look just past the next paragraph.
 .
 .IP
-These macros are defined on many (but not all) legacy Unix systems
-running classic troff.
+This macro is not defined on legacy Unix systems running classic
+troff.
 .
-To be certain your page will be portable to those systems, copy
-their definitions from the
+To be certain your page will be portable to those systems,
+copy its definition from the
 .B \%an-ext.tmac
 file of a
 .BR groff
 installation.
 .
+.
 .PP
 To summarize, the following macros cause a line break with the
 insertion of vertical space (which amount can be changed with the
@@ -556,20 +580,20 @@ also cause a break but no insertion of vertical space.
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH "MACROS TO SET FONTS"
 .
 The standard font is Roman; the default text size is 10\~point.
 .
-.TP
-.BI .SM " \fR[\fPtext\fR]\fP"
-Causes the text on the same line or the text on the next input line to
-appear in a font that is one point size smaller than the default font.
 .
 .TP
-.BI .SB " \fR[\fPtext\fR]\fP"
-Causes the text on the same line or the text on the next input line to
-appear in boldface font, one point size smaller than the default font.
+.BI .B " \fR[\fPtext\fR]\fP"
+Causes
+.I text
+to appear in bold face.
+.
+If no text is present on the line where the macro is called the text
+of the next input line appears in bold face.
+.
 .
 .TP
 .BI ".BI " text
@@ -589,33 +613,53 @@ would cause `this' and `that' to appear in bold face, while `word and'
 appears in italics.
 .RE
 .
+.
 .TP
-.BI ".IB " text
-Causes text to appear alternately in italic and bold face.
+.BI ".BR " text
+Causes text on the same line to appear alternately in bold face and
+roman.
 .
 The text must be on the same line as the macro call.
 .
+.
 .TP
-.BI ".RI " text
-Causes text on the same line to appear alternately in roman and
-italic.
+.FONT B .FONT I " <font name> <text> " R [ I "<font name> <text> ..." R ]
+Use different font names on a single line.
+.
+Useful font names include
+.BR R ,
+.BR I ,
+.BR B ,
+.BR CR ,
+.BR CI ,
+.BR CB .
 .
-The text must be on the same line as the macro call.
 .
 .TP
-.BI ".IR " text
-Causes text on the same line to appear alternately in italic and
-roman.
+.BI .I " \fR[\fPtext\fR]\fP"
+Causes
+.I text
+to appear in italic.
+.
+If no text is present on the line where the macro is called the text
+of the next input line appears in italic.
+.
+.
+.TP
+.BI ".IB " text
+Causes text to appear alternately in italic and bold face.
 .
 The text must be on the same line as the macro call.
 .
+.
 .TP
-.BI ".BR " text
-Causes text on the same line to appear alternately in bold face and
+.BI ".IR " text
+Causes text on the same line to appear alternately in italic and
 roman.
 .
 The text must be on the same line as the macro call.
 .
+.
 .TP
 .BI ".RB " text
 Causes text on the same line to appear alternately in roman and bold
@@ -623,27 +667,28 @@ face.
 .
 The text must be on the same line as the macro call.
 .
+.
 .TP
-.BI .B " \fR[\fPtext\fR]\fP"
-Causes
-.I text
-to appear in bold face.
+.BI ".RI " text
+Causes text on the same line to appear alternately in roman and
+italic.
+.
+The text must be on the same line as the macro call.
 .
-If no text is present on the line where the macro is called the text
-of the next input line appears in bold face.
 .
 .TP
-.BI .I " \fR[\fPtext\fR]\fP"
-Causes
-.I text
-to appear in italic.
+.BI .SB " \fR[\fPtext\fR]\fP"
+Causes the text on the same line or the text on the next input line to
+appear in boldface font, one point size smaller than the default font.
 .
-If no text is present on the line where the macro is called the text
-of the next input line appears in italic.
 .
+.TP
+.BI .SM " \fR[\fPtext\fR]\fP"
+Causes the text on the same line or the text on the next input line to
+appear in a font that is one point size smaller than the default font.
 .
-.\" -----------------------------------------------------------------
 .
+.\" -----------------------------------------------------------------
 .SH "MACROS TO DESCRIBE HYPERLINKS AND EMAIL ADDRESSES"
 .
 The following macros are not defined on legacy Unix systems
@@ -661,38 +706,39 @@ Using these macros helps ensure that you get hyperlinks when your
 manual page is rendered in a browser or other program that is
 Web-enabled.
 .
+.
 .TP
-.BI .UR " URL"
+.BI .MT " address"
 .TQ
-.BI .UE " \fR[\fPpunctuation\fR]\fP"
-Wrap a World Wide Web hyperlink.
+.BI .ME " \fR[\fPpunctuation\fR]\fP"
+Wrap an email address.
 .
-The argument to
-.B UR
-is the URL; thereafter, lines until
-.B UE
-are collected and used as the link text.
+The argument of
+.B MT
+is the address; text following, until
+.BR ME ,
+is a name to be associated with the address.
 .
 Any argument to the
-.B UE
-macro is pasted to the end of the text.
+.B ME
+macro is pasted to the end of the link text.
 .
 On a device that is not a browser,
 .
 .RS
 .IP
 .EX
-this is a link to
-\&.UR http://\e:randomsite.org/\e:fubar
-some random site
-\&.UE ,
-given as an example
+contact
+\&.UR fred.foonly@\e:fubar.net
+Fred Foonly
+\&.UE
+for more information
 .EE
 .RE
 .
 .IP
-usually displays like this: \[lq]this is a link to some random
-site <http://\:randomsite.org/\:fubar>, given as an example\[rq].
+usually displays like this: \[lq]contact Fred Foonly
+<fred.foonly@\:fubar.net> for more information\[rq].
 .
 .IP
 The use of
@@ -700,38 +746,39 @@ The use of
 to insert hyphenless breakpoints is a groff extension and can
 be omitted.
 .
+.
 .TP
-.BI .MT " address"
+.BI .UR " URL"
 .TQ
-.BI .ME " \fR[\fPpunctuation\fR]\fP"
-Wrap an email address.
+.BI .UE " \fR[\fPpunctuation\fR]\fP"
+Wrap a World Wide Web hyperlink.
 .
-The argument of
-.B MT
-is the address; text following, until
-.BR ME ,
-is a name to be associated with the address.
+The argument to
+.B UR
+is the URL; thereafter, lines until
+.B UE
+are collected and used as the link text.
 .
 Any argument to the
-.B ME
-macro is pasted to the end of the link text.
+.B UE
+macro is pasted to the end of the text.
 .
 On a device that is not a browser,
 .
 .RS
 .IP
 .EX
-contact
-\&.UR fred.foonly@\e:fubar.net
-Fred Foonly
-\&.UE
-for more information
+this is a link to
+\&.UR http://\e:randomsite.org/\e:fubar
+some random site
+\&.UE ,
+given as an example
 .EE
 .RE
 .
 .IP
-usually displays like this: \[lq]contact Fred Foonly
-<fred.foonly@\:fubar.net> for more information\[rq].
+usually displays like this: \[lq]this is a link to some random
+site <http://\:randomsite.org/\:fubar>, given as an example\[rq].
 .
 .IP
 The use of
@@ -741,7 +788,6 @@ be omitted.
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH "MACROS TO DESCRIBE COMMAND SYNOPSES"
 .
 The following macros are not defined on legacy Unix systems
@@ -760,6 +806,16 @@ They also assist automated translation tools and help browsers in
 recognizing command synopses and treating them differently from
 running text.
 .
+.
+.TP
+.BI .OP " key value"
+Describe an optional command argument.
+.
+The arguments of this macro are set surrounded by option braces
+in the default Roman font; the first argument is printed with
+a bold face, while the second argument is typeset as italic.
+.
+.
 .TP
 .BI .SY " command"
 Begin synopsis.
@@ -774,13 +830,6 @@ plus a space.
 .
 This produces the traditional look of a Unix command synopsis.
 .
-.TP
-.BI .OP " key value"
-Describe an optional command argument.
-.
-The arguments of this macro are set surrounded by option braces
-in the default Roman font; the first argument is printed with
-a bold face, while the second argument is typeset as italic.
 .
 .TP
 .B .YS
@@ -851,7 +900,6 @@ You can insert plain text as well; this looks like the traditional
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH "MISCELLANEOUS"
 .
 The default indentation is 7.2n in troff mode and 7n in nroff mode
@@ -859,6 +907,25 @@ except for
 .B grohtml
 which ignores indentation.
 .
+.
+.TP
+.BI .AT " \fR[\fPsystem \fR[\fPrelease\fR]]\fP"
+Alter the footer for use with \f[CR]AT&T\f[]
+.IR \%man\~pages .
+This command exists only for compatibility; don't use it.
+.
+See the
+.I groff
+info manual for more.
+.
+.
+.TP
+.B .BT
+Print the footer string.
+.
+Redefine this macro to get control of the footer.
+.
+.
 .TP
 .B .DT
 Set tabs every 0.5\~inches.
@@ -914,15 +981,13 @@ Thus, information or distinctions that you use
 .B PD
 to express are likely to be lost.
 .
+.
 .TP
-.BI .AT " \fR[\fPsystem \fR[\fPrelease\fR]]\fP"
-Alter the footer for use with \f[CR]AT&T\f[]
-.IR \%man\~pages .
-This command exists only for compatibility; don't use it.
+.B .PT
+Print the header string.
+.
+Redefine this macro to get control of the header.
 .
-See the
-.I groff
-info manual for more.
 .
 .TP
 .BI .UC " \fR[\fPversion\fR]\fP"
@@ -934,32 +999,20 @@ See the
 .I groff
 info manual for more.
 .
-.TP
-.B .PT
-Print the header string.
-.
-Redefine this macro to get control of the header.
-.
-.TP
-.B .BT
-Print the footer string.
-.
-Redefine this macro to get control of the footer.
 .
 .PP
 The following strings are defined:
 .
-.TP
-.B \e*S
-Switch back to the default font size.
 .
 .TP
 .B \e*R
 The `registered' sign.
 .
+.
 .TP
-.B \e*(Tm
-The `trademark' sign.
+.B \e*S
+Switch back to the default font size.
+.
 .
 .TP
 .B \e*(lq
@@ -969,12 +1022,19 @@ Left and right quote.
 .
 This is equal to `\e(lq' and `\e(rq', respectively.
 .
+.
 .TP
 .B \e*(HF
 The typeface used to print headings and subheadings.
 .
 The default is `B'.
 .
+.
+.TP
+.B \e*(Tm
+The `trademark' sign.
+.
+.
 .PP
 If a preprocessor like
 .B @g@tbl
@@ -984,11 +1044,13 @@ is needed, it has become common to make the first line of the
 .I \%man\~page
 look like this:
 .
+.
 .PP
 .RS
 .BI '\e"\  word
 .RE
 .
+.
 .PP
 Note the single space character after the double quote.
 .I word
@@ -1005,7 +1067,6 @@ preprocessor(s).
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH "PORTABILITY AND TROFF REQUESTS"
 .
 Since the
@@ -1022,6 +1083,7 @@ See the
 .I groff
 info pages for a complete reference of all requests.
 .
+.
 .PP
 Note, however, that using raw troff requests is likely to make your
 page render poorly on the (increasingly common) class of viewers that
@@ -1032,6 +1094,7 @@ and page sizes that may break in an HTML environment; also, many of
 these viewers don't interpret the full troff vocabulary, a problem
 which can lead to portions of your text being silently dropped.
 .
+.
 .PP
 For portability to modern viewers, it is best to write your page
 entirely in the requests described on this page.
@@ -1043,6 +1106,7 @@ Further, it is best to completely avoid those we have described as
 and
 .BR DT ).
 .
+.
 .PP
 The macros we have described as extensions
 .RB ( .EX / .EE ,
@@ -1057,9 +1121,9 @@ If in doubt, copy the implementation onto your page.
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH FILES
 .
+.
 .TP
 .B man.tmac
 .TQ
@@ -1067,6 +1131,7 @@ If in doubt, copy the implementation onto your page.
 These are wrapper files to call
 .BR andoc.tmac .
 .
+.
 .TP
 .B andoc.tmac
 Use this file in case you don't know whether the
@@ -1076,12 +1141,14 @@ macros or the
 package should be used.
 Multiple man pages (in either format) can be handled.
 .
+.
 .TP
 .B an-old.tmac
 Most
 .B man
 macros are contained in this file.
 .
+.
 .TP
 .B an-ext.tmac
 The extension macro definitions for
@@ -1110,6 +1177,7 @@ If you must use your own definitions for these macros, they must be
 given after calling
 .BR TH .
 .
+.
 .TP
 .B man.local
 Local changes and customizations should be put into this file.
@@ -1119,6 +1187,7 @@ Local changes and customizations should be put into this file.
 .
 .SH "SEE ALSO"
 .
+.
 .PP
 .BR @g@tbl (@MAN1EXT@),
 .BR @g@eqn (@MAN1EXT@),
@@ -1129,7 +1198,6 @@ Local changes and customizations should be put into this file.
 .
 .
 .\" -----------------------------------------------------------------
-.
 .SH AUTHORS
 .
 This manual page was originally written for the Debian GNU/Linux
@@ -1138,17 +1206,31 @@ system by
 Susan G. Kleinmann
 .ME .
 .
+.
+.PP
 It was corrected and updated by
 .MT wl@gnu.org
 Werner Lemberg
 .ME .
 .
+.
+.PP
 The extension macros were documented (and partly designed) by
 .MT esr@thyrsus.com
 Eric S. Raymond
 .ME ;
 he also wrote the portability advice.
 .
+.
+.PP
+It was put under GPL2 and ordered and extended by
+.MT groff-bernd.warken-72@web.de
+Bernd Warken
+.ME .
+.
+.
+.\" ----------------------------------------------------------------------
+.\" ### Emacs settings:
 .\" Local Variables:
 .\" mode: nroff
 .\" End:


hooks/post-receive
-- 
GNU troff


From MAILER-DAEMON Sun Jan 05 05:43:57 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1VzlBV-0001Bo-P6
	for mharc-groff-commit@gnu.org; Sun, 05 Jan 2014 05:43:57 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54093)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1Vzl1T-0006vR-Kf
	for groff-commit@gnu.org; Sun, 05 Jan 2014 05:33:54 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1Vzl1A-0007ma-D3
	for groff-commit@gnu.org; Sun, 05 Jan 2014 05:33:35 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:56271)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1Vzl1A-0007mS-2w
	for groff-commit@gnu.org; Sun, 05 Jan 2014 05:33:16 -0500
Received: from bwarken by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1Vzl19-0002Gu-3v
	for groff-commit@gnu.org; Sun, 05 Jan 2014 10:33:15 +0000
Date: Sun, 05 Jan 2014 10:33:15 +0000
Message-Id: <E1Vzl19-0002Gu-3v@vcs.savannah.gnu.org>
From: "Bernd Warken" <groff-bernd.warken-72@web.de>
To: groff-commit@gnu.org
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: 309660d6de892de92c9b4b89c160cb4e4606736b
X-Git-Newrev: 6b731a6d6af7ccb12393f80fec13c25ae424cf8c
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
X-Mailman-Approved-At: Sun, 05 Jan 2014 05:43:56 -0500
Subject: [Groff-commit] GNU troff branch, master,
	updated. 6b731a6d6af7ccb12393f80fec13c25ae424cf8c
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 05 Jan 2014 10:33:54 -0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU troff".

http://git.sv.gnu.org/gitweb/?p=groff.git;a=commitdiff;h=6b731a6d6af7ccb12393f80fec13c25ae424cf8c

The branch, master has been updated
       via  6b731a6d6af7ccb12393f80fec13c25ae424cf8c (commit)
      from  309660d6de892de92c9b4b89c160cb4e4606736b (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 6b731a6d6af7ccb12393f80fec13c25ae424cf8c
Author: Bernd Warken <groff-bernd.warken-72@web.de>
Date:   Sun Jan 5 11:30:22 2014 +0100

    Rename contrib/RUNOFF to contrib/groff_filenames.
    Remove iman page runoff.man.
    Remove the RUNOFF parts in groff_filenames.man.
    Change Makefile.sub correspoondingly.

-----------------------------------------------------------------------

Summary of changes:
 contrib/RUNOFF/runoff.man                          |11247 --------------------
 contrib/{RUNOFF => groff_filenames}/ChangeLog      |    9 +
 contrib/{RUNOFF => groff_filenames}/Makefile.sub   |    7 +-
 .../groff_filenames.man                            |  216 +-
 4 files changed, 15 insertions(+), 11464 deletions(-)
 delete mode 100644 contrib/RUNOFF/runoff.man
 rename contrib/{RUNOFF => groff_filenames}/ChangeLog (84%)
 rename contrib/{RUNOFF => groff_filenames}/Makefile.sub (90%)
 rename contrib/{RUNOFF => groff_filenames}/groff_filenames.man (75%)

diff --git a/contrib/RUNOFF/runoff.man b/contrib/RUNOFF/runoff.man
deleted file mode 100644
index 269c932..0000000
--- a/contrib/RUNOFF/runoff.man
+++ /dev/null
@@ -1,11247 +0,0 @@
-.\" t
-.TH RUNOFF @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
-.SH NAME
-RUNOFF \[em] the predecessor of the \f[CI]roff\f[] langugage
-.
-.\" The .SH was moved to this place in order to appease `apropos'.
-.
-.\" --------------------------------------------------------------------
-.\" Legalese
-.\" --------------------------------------------------------------------
-.
-.de authors
-This file was written by Bernd Warken
-.MT groff\-bernd.warken\-72@web.de
-.ME .
-..
-.
-.
-.de copying
-Copyright \(co 2013
-.RS
-.ft CI
-Free Software Foundation, Inc.
-.ft R
-.RE
-.
-.P
-Last update: 14 May 2013
-.
-.P
-This file is part of
-.ft CI
-groff\\f[R], a free software project.
-.
-.P
-You can redistribute it and/or modify it under the terms of the
-.nh
-.ft CI
-GNU General Public License
-.ft R
-.hy
-as published by the
-.nh
-.ft CI
-Free Software Foundation (FSF)\\f[R],
-.hy
-either version 3 of the License, or (at your option) any later version.
-.
-.P
-You should have received a copy of the
-.nh
-.ft CI
-GNU General Public License
-.ft R
-.hy
-along with
-.ft CI
-groff\\f[R],
-see the files
-.nh
-.ft CB
-COPYING
-.ft R
-and
-.ft CB
-LICENSE
-.ft R
-.hy
-in the top directory of the
-.ft CI
-groff
-.ft R
-source package.
-.
-.P
-You can also visit
-.UR http://\\:www.gnu.org/\\:licenses
-.UE .
-..
-.
-.
-.\" --------------------------------------------------------------------
-.\" Setup
-.\" --------------------------------------------------------------------
-.
-.ds1 Ellipsis "\&.\|.\|.\&\"
-.
-.
-.\" --------------------------------------------------------------------
-.\" Macro definitions
-.\" --------------------------------------------------------------------
-.
-.\" --------------------------------------------------------------------
-.\" .FONT (<font name> <text> [<font name> <text> ...])
-.\"
-.\" Print in different fonts: R, I, B, CR, CI, CB
-.\"
-.de1 FONT
-.  if (\\n[.$] = 0) \{\
-.	nop \&\f[P]\&
-.	return
-.  \}
-.  ds result \&
-.  while (\\n[.$] >= 2) \{\
-.	as result \,\f[\\$1]\\$2
-.	if !"\\$1"P" .as result \f[P]
-.	shift 2
-.  \}
-.  if (\\n[.$] = 1) .as result \,\f[\\$1]
-.  nh
-.  nop \\*[result]\&
-.  hy
-..
-.
-.\" --------------------------------------------------------------------
-.\" .Topic  ([<indent>])
-.\"
-.\" A bulleted paragraph
-.\"
-.de Topic
-.  ie \\n[.$]=0 \
-.    ds @indent 2m\"
-.  el \
-.    ds @indent \\$1\"
-.  IP \[bu] \\*[@indent]
-.  rm @indent
-..
-.
-.\" --------------------------------------------------------------------
-.\" .UL (<text to underline> [<append>])
-.\"
-.\" Underline $1 and append $2 without underline
-.\"
-.de UL
-.  if t \}\
-.    nop \Z'\\$1'\v'.25m'\D'l \w'\\$1'u 0'\v'-.25m'\\$2
-.    return
-.  \}
-.  ul 1
-\\$1\c
-\\$2
-..
-.
-.\" --------------------------------------------------------------------
-.\" .TableHDTBL - table using hdtbl for troff
-.\"
-.de1 TableHDTBL eHDTBL
-.
-This list of commands is a table over 5 pages.
-.
-.
-.bp
-.
-.\" use groff_hdtbl
-.\" mso hdtbl.tmac
-.
-.
-.\" --------------------------------------------------------------------
-.\" hdtbl Table: List of Commands (Alphabetical) page 1/5
-.\" --------------------------------------------------------------------
-.
-.hy
-.fi
-.
-.TBL cols=3
-.TR hl=d ".TH colspan=2 Command or Abbreviation" ".TH Related Commands"
-.\" TR hl=d ".TD colspan=2 Command or Abbreviation" ".TD Related Commands"
-.
-.
-.nf
-.nh
-.
-.
-.\" A ==================================================================
-.
-.TR
-.TD
-.FONT CB ".AP"
-.TD
-.FONT R "(=" CB ".AUTOPARAGRAPH" R ")"
-.TD
-.
-.
-.TR
-.TD
-.FONT CB ".APPENDIX " I "text"
-.TD
-.FONT R "(=" CB ".AX" R ")"
-.TD
-.FONT CB ".NUMBER APPENDIX " I "a"
-.
-.TR
-.TD
-.FONT CB ".AX"
-.TD
-.FONT R "(=" CB ".APPENDIX" R ")"
-.TD
-.
-.TR hl=d
-.TD
-.FONT CB ".AUTOPARAGRAPH"
-.TD
-.FONT R "(=" CB ".AP" R ")"
-.TD
-.FONT CB ".NOAUTOPARAGRAPH"
-.br
-.FONT R "(" CB ".NAP" R ")"
-.
-.\" B ==================================================================
-.
-.TR
-.TD
-.FONT CB ".B"
-.TD
-.FONT R "(=" CB ".BLANK" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".BLANK" I " n"
-.TD
-.FONT  R "(=" CB ".B" R ")"
-.TD
-.FONT CB ".SKIP" I " n"
-.br
-.FONT R "(" CB ".S" R ")"
-.
-.TR
-.TD
-.FONT CB ".BR"
-.TD
-.FONT R "(=" CB ".BREAK" R ")"
-.TD
-.
-.TR hl=d
-.TD
-.FONT CB ".BREAK"
-.TD
-.FONT R "(" CB ".BR" R ")"
-.TD
-.
-.
-.\" C ==================================================================
-.
-.TR
-.TD
-.FONT CB ".C"
-.TD
-.FONT R "(=" CB ".CENTRE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".CENTER"
-.TD
-.FONT R "(=" CB ".CENTRE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".CENTRE" I " n" CB ";" I "text"
-.TD
-.FONT R "(=" CB ".C" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".CH"
-.TD
-.FONT R "(=" CB ".CHAPTER" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".CHAPTER" I " text"
-.TD
-.FONT R "(=" CB ".CH" R ")"
-.TD
-.FONT CB ".NUMBER CHAPTER" I " n"
-.
-.TR hl=d
-.TD
-.FONT CB ".COMMENT" I " text"
-.TD
-.TD
-.
-.
-.\" D ==================================================================
-.
-.TR
-.TD
-.FONT CB ".DO INDEX" I " text"
-.TD
-.FONT R "(=" CB ".DX" R ")"
-.TD
-.FONT CB ".PRINT INDEX"
-.br
-.FONT R "(" CB ".PX" R ")"
-.
-.TR hl=d
-.TD
-.FONT CB ".DX"
-.TD
-.FONT R "(=" CB ".DO INDEX" R ")"
-.TD
-.
-.
-.\" E ==================================================================
-.
-.TR
-.TD
-.FONT CB ".ELS"
-.TD
-.FONT R "(=" CB ".END LIST" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".EN"
-.TD
-.FONT R "(=" CB ".END NOTE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".END LIST"
-.TD
-.FONT R "(=" CB ".ELS" R ")"
-.TD
-.FONT CB ".LIST " I "n"
-.br
-.FONT R "(" CB ".LS" R ")"
-.
-.TR
-.TD
-.FONT CB ".END LITERAL"
-.TD
-.FONT R "(=" CB ".ELI" R ")"
-.TD
-.FONT CB ".LITERAL"
-.FONT R "(" CB ".LIT" R ")"
-.
-.TR
-.TD
-.FONT CB ".END NOTE"
-.TD
-.FONT R "(=" CB ".EN" R ")"
-.TD
-.FONT CB ".NOTE " I "text"
-.br
-.FONT R "(" CB ".NT" R ")"
-.
-.TR hl=d
-.TD
-.FONT CB ".END SUBPAGE"
-.TD
-.TD
-.FONT CB ".SUBPAGE"
-.
-.
-.\" F ==================================================================
-.
-.TR
-.TD
-.FONT CB ".F"
-.TD
-.FONT R "(=" CB ".FILL" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".FG"
-.TD
-.FONT R "(=" CB ".FIGURE" R ")"
-.TD
-.
-.
-.ETB
-.
-.
-.bp
-.\" --------------------------------------------------------------------
-.\" hdtbl Table: List of Commands (Alphabetical) page 2/5
-.\" --------------------------------------------------------------------
-.
-.fi
-.hy
-.
-.TBL cols=3
-.TR hl=d ".TH colspan=2 Command or Abbreviation" ".TH Related Commands"
-.
-.
-.nf
-.nh
-.
-.
-.\" F2 =================================================================
-.
-.TR
-.TD
-.FONT CB ".FIGURE" I " n"
-.TD
-.FONT R "(=" CB ".FG" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".FILL"
-.TD
-.FONT R "(=" CB ".F" R ")"
-.TD
-.FONT CB ".NOFILL"
-.br
-.FONT R "(" CB ".NF" R ")"
-.
-.TR
-.TD
-.FONT CB ".FIRST TITLE" I " text"
-.TD
-.FONT R "(=" CB ".FT" R ")"
-.TD
-.FONT CB ".TITLE" I " text"
-.
-.TR
-.TD
-.FONT CB ".FLAGS CAPITALIZE"
-.TD
-.FONT R "(=" CB ".FL CAPITALIZE" R ")"
-.TD
-.FONT CB ".NO FLAGS CAPITALIZE"
-.br
-.FONT R "(" CB ".NFL" R ")"
-.
-.TR
-.TD
-.FONT CB ".FLAGS HYPHENATE"
-.TD
-.FONT R "(=" CB ".FL HYPHENATE" R ")"
-.TD
-.FONT CB ".NO FLAGS HYPHENATE"
-.br
-.FONT R "(" CB ".NFH" R ")"
-.
-.TR
-.TD
-.FONT CB ".FN"
-.TD
-.FONT R "(=" CB ".FOOTNOTE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".FOOTNOTE" I " n"
-.TD
-.FONT R "(=" CB ".FN" R ")"
-.TD
-.
-.TR hl=d
-.TD
-.FONT CB ".FT"
-.TD
-.FONT R "(=" CB ".FIRST TITLE" R ")"
-.TD
-.
-.
-.\" G ==================================================================
-.\" H ==================================================================
-.
-.TR
-.TD
-.FONT CB ".HD"
-.TD
-.FONT R "(=" CB ".HEADER" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".HEADER" I " arg"
-.br
-.FONT R "[" I "arg" R "=" CB "UPPER" R ", " CB "LOWER" R ", or " CB "MIXED]"
-.TD
-.FONT R "(=" CB ".HD" R ")"
-.TD
-.FONT CB ".NOHEADER "
-.br
-.FONT R "(" CB ".NHD" R ")"
-.
-.TR
-.TD
-.FONT CB ".HEADER LEVEL" I " n text"
-.TD
-.FONT R "(=" CB ".HL" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".HL"
-.TD
-.FONT R "(=" CB ".HEADER LEVEL" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".HY"
-.TD
-.FONT R "(=" CB ".HYPHENATION" R ")"
-.TD
-.
-.TR hl=d
-.TD
-.FONT CB ".HYPHENATION"
-.TD
-.FONT R "(=" CB ".HY" R ")"
-.TD
-.FONT CB ".NO HYPHENATION"
-.br
-.FONT R "(" CB ".NHY" R ")"
-.
-.
-.\" I ==================================================================
-.
-.TR
-.TD
-.FONT CB ".I"
-.TD
-.FONT R "(=" CB ".INDENT" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".INDENT" I " n"
-.TD
-.FONT R "(=" CB ".I" R ")"
-.TD
-.
-.TR hl=d
-.TD
-.FONT CB ".INDEX" I " text"
-.TD
-.FONT R "(=" CB ".X" R ")"
-.TD
-.
-.
-.\" J ==================================================================
-.
-.TR
-.TD
-.FONT CB ".J"
-.TD
-.FONT R "(=" CB ".JUSTIFY" R ")"
-.TD
-.
-.TR hl=d
-.TD
-.FONT CB ".JUSTIFY"
-.TD
-.FONT R "(=" CB ".J" R ")"
-.TD
-.FONT CB ".NOJUSTIFY"
-.br
-.FONT R "(" CB ".NJ" R ")"
-.
-.
-.\" K ==================================================================
-.\" L ==================================================================
-.
-.TR
-.TD
-.FONT CB ".LC"
-.TD
-.FONT R "(=" CB ".LOWER CASE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".LE"
-.TD
-.FONT R "(=" CB ".LIST ELEMENT" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".LEFT MARGIN" I " n"
-.TD
-.FONT R "(=" CB ".LM" R ")"
-.TD
-.FONT CB ".RIGHT MARGIN" I " n"
-.br
-.FONT R "(" CB ".RM" R ")"
-.
-.TR
-.TD
-.FONT CB ".LIST" I " n"
-.TD
-.FONT R "(=" CB ".LS" R ")"
-.TD
-.FONT CB ".END LIST"
-.br
-.FONT R "(" CB ".ELS" R ")"
-.
-.ETB
-.
-.
-.bp
-.\" --------------------------------------------------------------------
-.\" hdtbl Table: List of Commands (Alphabetical) page 3/5
-.\" --------------------------------------------------------------------
-.
-.fi
-.hy
-.
-.TBL cols=3
-.TR hl=d ".TH colspan=2 Command or Abbreviation" ".TH Related Commands"
-.
-.
-.nf
-.nh
-.
-.\" L2 =================================================================
-.
-.TR
-.TD
-.FONT CB ".LIST ELEMENT;" I "text"
-.TD
-.FONT R "(=" CB ".LE" R ")"
-.TD
-.FONT CB ".END LIST"
-.br
-.FONT R "(" CB ".ELS" R ")"
-.
-.TR
-.TD
-.FONT CB ".LIT"
-.TD
-.FONT R "(=" CB ".LITERAL" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".LITERAL"
-.TD
-.FONT R "(=" CB .LIT R ")"
-.TD
-.FONT CB ".END LITERAL"
-.FONT R ( CB .ELI R )
-.
-.TR
-.TD
-.FONT CB ".LM"
-.TD
-.FONT R "(=" CB ".LEFT MARGIN" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".LOWER CASE"
-.TD
-.FONT R "(=" CB ".LC" R ")"
-.TD
-.FONT CB ".UPPER CASE"
-.br
-.FONT R "(" CB ".UC" R ")"
-.
-.TR hl=d
-.TD
-.FONT CB ".LS"
-.TD
-.FONT R "(=" CB ".LIST" R ")"
-.TD
-.
-.
-.\" M ==================================================================
-.\" N ==================================================================
-.
-.TR
-.TD
-.FONT CB ".NAP"
-.TD
-.FONT R "(=" CB ".NOAUTOPARAGRAPH" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NF"
-.TD
-.FONT R "(=" CB ".NOFILL" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NFC"
-.TD
-.FONT R "(=" CB ".NO FLAGS CAPITALIZE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NFH"
-.TD
-.FONT R "(=" CB ".NO FLAGS HYPHENATE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NFL"
-.TD
-.FONT R "(=" CB ".NO FLAGS CAPITALIZE"
-.br
-and
-.br
-.FONT CB ".NO FLAGS HYPHENATE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NHD"
-.TD
-.FONT R "(=" CB ".NO HEADER" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NHY"
-.TD
-.FONT R "(=" CB ".NO HYPHENATION" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NJ"
-.TD
-.FONT R "(=" CB ".NO JUSTIFY" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NM"
-.TD
-.FONT R "(=" CB ".NUMBER" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NNM"
-.TD
-.FONT R "(=" CB ".NO NUMBER" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NOAUTOPARAGRAPH"
-.TD
-.FONT R "(=" CB ".NAP" R ")"
-.TD
-.FONT CB ".AUTOPARAGRAPH"
-.br
-.FONT R "(" CB ".AP" R ")"
-.br
-.FONT CB ".PARAGRAPH" I " h" CB "," I "v" CB "," I "t"
-.br
-.FONT R "(" CB ".P" R ")"
-.
-.TR
-.TD
-.FONT CB ".NOFILL"
-.TD
-.FONT R "(=" CB ".NF" R ")"
-.TD
-.FONT CB ".FILL"
-.br
-.FONT R "(" CB ".F" R ")"
-.
-.TR
-.TD
-.FONT CB ".NO FLAGS CAPITALIZE"
-.TD
-.FONT R "(=" CB ".NFL" R ")"
-.TD
-.FONT CB ".FLAGS CAPITALIZE"
-.br
-.FONT R ( CB ".FL CAPITALIZE" R )
-.
-.TR
-.TD
-.FONT CB ".NO FLAGS HYPHENATE"
-.TD
-.FONT R "(=" CB ".NFH" R ")"
-.TD
-.FONT CB ".FLAGS HYPHENATE"
-.
-.TR
-.TD
-.FONT CB ".NOHEADER"
-.TD
-.FONT R "(=" CB ".NHD" R ")"
-.TD
-.FONT CB ".HEADER " I "arg"
-.br
-.FONT R "(" CB ".HD" R ")"
-.
-.ETB
-.
-.
-.bp
-.\" --------------------------------------------------------------------
-.\" hdtbl Table: List of Commands (Alphabetical) page 4/5
-.\" --------------------------------------------------------------------
-.
-.fi
-.hy
-.
-.TBL cols=3
-.TR hl=d ".TH colspan=2 Command or Abbreviation" ".TH Related Commands"
-.
-.
-.nf
-.nh
-.
-.\" N2 =================================================================
-.
-.TR
-.TD
-.FONT CB ".NO HYPHENATION"
-.TD
-.FONT R "(=" CB ".NHY" R ")"
-.TD
-.FONT CB ".HYPHENATION"
-.br
-.FONT R "(" CB ".HY" R ")"
-.
-.TR
-.TD
-.FONT CB ".NOJUSTIFY"
-.TD
-.FONT R "(=" CB ".NJ" R ")"
-.TD
-.FONT CB ".JUSTIFY"
-.br
-.FONT R "(" CB ".J" R ")"
-.
-.TR
-.TD
-.FONT CB ".NONUMBER"
-.TD
-.FONT R "(=" CB ".NNM" R ")"
-.TD
-.FONT CB ".NUMBER " I "n"
-.br
-.FONT R "(" CB ".NM" R ")"
-.
-.TR
-.TD
-.FONT CB ".NOPERIOD"
-.TD
-.FONT R "(=" CB ".NPR" R ")"
-.TD
-.FONT CB ".PERIOD"
-.br
-.FONT R "(" CB ".PR" R ")"
-.
-.TR
-.TD
-.FONT CB ".NOTE" I " text"
-.TD
-.FONT R "(=" CB ".NT" R ")"
-.TD
-.FONT CB ".END NOTE"
-.br
-.FONT R "(" CB ".EN" R ")"
-.
-.TR
-.TD
-.FONT CB ".NPR"
-.TD
-.FONT R "(=" CB ".NO PERIOD" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NT"
-.TD
-.FONT R "(=" CB ".NOTE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".NUMBER APPENDIX" I " a"
-.TD
-.TD
-.FONT CB ".APPENDIX" I " text"
-.
-.TR hl=d
-.TD
-.FONT CB ".NUMBER CHAPTER " I "n"
-.TD
-.TD
-.FONT CB ".CHAPTER text"
-.
-.
-.\" P ==================================================================
-.
-.TR
-.TD
-.FONT CB ".P"
-.TD
-.FONT R "(=" CB ".PARAGRAPH" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".PAGE"
-.TD
-.FONT R "(=" CB ".PG" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".PAGE SIZE"
-.TD
-.FONT R "(=" CB ".PAPER SIZE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".PAPER SIZE" I " v" CB "," I "h"
-.br
-.FONT R "(=" CB ".PS" R ", " CB ".PAGE SIZE" R ")"
-.TD
-.TD
-.
-.TR
-.TD
-.FONT CB ".PERIOD"
-.TD
-.FONT R "(=" CB ".PR" R ")"
-.TD
-.FONT CB ".NOPERIOD"
-.br
-.FONT R "(" CB ".NPR" R ")"
-.
-.TR
-.TD
-.FONT CB ".PG"
-.TD
-.FONT R "(=" CB ".PAGE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".PITCH"
-.TD
-.FONT R "(=" CB ".PIT" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".PRINT INDEX"
-.TD
-.FONT R "(=" CB ".PX" R ")"
-.TD
-.FONT CB ".DO INDEX" I " text"
-.FONT R "(" CB ".DX" R ")"
-.
-.TR
-.TD
-.FONT CB ".PS"
-.TD
-.FONT R "(=" CB ".PAPER SIZE" R ")"
-.TD
-.
-.TR hl=d
-.TD
-.FONT CB ".PX"
-.TD
-.FONT R "(=" CB ".PRINT INDEX" R ")"
-.TD
-.
-.
-.\" R ==================================================================
-.
-.TR
-.TD
-.FONT CB ".RIGHT MARGIN " I "n"
-.TD
-.FONT R "(=" CB ".RM" R ")"
-.TD
-.
-.TR hl=d
-.TD
-.FONT CB ".RM"
-.TD
-.FONT R "(=" CB ".RIGHT MARGIN" R ")"
-.TD
-.
-.
-.\" S ==================================================================
-.
-.TR
-.TD
-.FONT CB ".S"
-.TD
-.FONT R "(=" CB ".SKIP" R ")"
-.TD
-.
-.ETB
-.
-.
-.bp
-.\" --------------------------------------------------------------------
-.\" hdtbl Table: List of Commands (Alphabetical) page 5/5
-.\" --------------------------------------------------------------------
-.
-.fi
-.hy
-.
-.TBL cols=3
-.TR hl=d ".TH colspan=2 Command or Abbreviation" ".TH Related Commands"
-.
-.
-.nf
-.nh
-.
-.\" S2 =================================================================
-.
-.TR
-.TD
-.FONT CB ".SD"
-.TD
-.FONT R "(=" CB ".STANDARD" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".SKIP" I " n"
-.TD
-.FONT R "(=" CB ".S" R ")"
-.TD
-.FONT CB ".BLANK" I " n"
-.br
-.FONT R "(" CB ".B" R ")"
-.
-.TR
-.TD
-.FONT CB ".SP"
-.TD
-.FONT R "(=" CB ".SPACING" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".SPACING" I " n"
-.TD
-.FONT R "(=" CB ".SP" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".ST"
-.TD
-.FONT R "(=" CB ".SUBTITLE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".SUBPAGE"
-.TD
-.TD
-.FONT CB ".END SUBPAGE"
-.
-.TR hl=d
-.TD
-.FONT CB ".SUBTITLE" I " text"
-.TD
-.FONT R "(=" CB ".ST" R ")"
-.TD
-.
-.
-.\" T ==================================================================
-.
-.TR
-.TD
-.FONT CB ".T"
-.TD
-.FONT R "(=" CB ".TITLE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".TAB STOPS" I " n,n, \*[Ellipsis] ,n"
-.TD
-.FONT R "(=" CB ".TS" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".TEST PAGE" I " n"
-.TD
-.FONT R "(=" CB ".TP" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".TITLE" I " text"
-.TD
-.FONT R "(=" CB ".T" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".TP"
-.TD
-.FONT R "(=" CB ".TEST PAGE" R ")"
-.TD
-.
-.TR hl=d
-.TD
-.FONT CB ".TS"
-.TD
-.FONT R "(=" CB ".TAB STOPS" R ")"
-.TD
-.
-.
-\" U ==================================================================
-.
-.TR
-.TD
-.FONT CB ".UC"
-.TD
-.FONT R "(=" CB ".UPPER CASE" R ")"
-.TD
-.
-.TR
-.TD
-.FONT CB ".UPPER CASE"
-.TD
-.FONT R "(=" CB ".UC" R ")"
-.TD
-.FONT CB ".LOWER CASE"
-.br
-.FONT R "(" CB ".LC" R ")"
-.
-.
-\" U ==================================================================
-.
-.TR
-.TD
-.FONT CB ".X"
-.TD
-.FONT R "(=" CB ".INDEX" R ")"
-.TD
-.
-.
-.ETB
-.
-.
-.fi
-.hy
-.
-.bp
-.
-.
-.eHDTBL
-.\" end of .de1 TableHDTBL
-.\" --------------------------------------------------------------------
-.
-.
-.\" --------------------------------------------------------------------
-.\" End of macro definitions.
-.\" --------------------------------------------------------------------
-.
-.
-.\" --------------------------------------------------------------------
-.SH DESCRIPTION
-..\" --------------------------------------------------------------------
-.
-.FONT CI RUNOFF
-is a language for creating documents.
-.
-This was the first document language at all.
-.
-It is the ancestor of
-.FONT CI roff R .
-.
-.
-.P
-See section
-.FONT CB "SEE ALSO"
-at the end of this document for internet addresses.
-.
-.
-.\" --------------------------------------------------------------------
-.SH HISTORY
-.\" --------------------------------------------------------------------
-.
-The first text processing language was
-.FONT CI DITTO
-at the
-.FONT CI CTSS
-computer at
-.FONT CI MIT R .
-.
-But now there isn't any documentation about the corresponding programs
-nor files written in the
-.FONT CI DITTO
-language.
-.
-.
-.P
-So
-.FONT CI RUNOFF
-can regarded as the oldest text processing language, because there is
-enough documentation and files written inb this language.
-.
-.
-.P
-.FONT CI RUNOFF
-was built by
-.FONT CI "Jerome H. Saltzer"
-in 1963 and 1964 at
-.FONT CR \%MIT
-using the operating system
-.FONT CR CTSS
-on computers
-.FONT CR "IBM 7090"
-and 
-.FONT CR 7094
-at the
-.FONT CI MIT
-in Boston.
-.
-.
-.P
-At the
-.FONT CI Unix
-operating system, the
-.FONT CI RUNOFF
-language was the base for the generation of the text generator language
-.IR \%roff .
-.
-Today
-.I \%roff
-is maintained by
-.IR \%GNU\~troff ,
-the program 
-.BR \%groff (@MAN1EXT@)
-and its language
-.BR \%groff (@MAN7EXT@).
-.
-So
-.FONT CI RUNOFF
-is the ancestor for
-.IR \%groff .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Old RUNOFF Documentation
-.\" --------------------------------------------------------------------
-.
-Look at section
-.FONT CR "SEE ALSO"
-for the internet connections to these documents.
-.
-.
-.P
-All started at the operating system called
-.I \%CTSS
-in the early 1960s at the
-.IR \%MIT .
-.
-.
-.P
-There was a first documentation in 1964 by
-.FONT CI Saltzer
-who created the
-.FONT CI RUNOFF
-language.
-.
-He published a documentation titled
-.FONT CI "Jerome H. Saltzer \(em TYPSET and RUNOFF, Memorandum editor and \
-type\-out commands" R .
-.
-.
-.P
-In december 1966,
-.FONT CI Saltzer
-published an updated documentation
-.FONT CI "Jerome H. Saltzer \(em Manuscript Typing and Editing" R .
-.
-This article can be regarded as the documentation of the original
-.FONT CI RUNOFF R .
-.
-.
-.P
-Moreover
-.FONT CI Saltzer
-published another document in 1965.
-.
-It's titled
-.FONT CI "Jerome H. Saltzer \(em Experimental Additions to the RUNOFF Command"
-.
-We integrate the
-.I "control words"
-in this documentation in a section about
-.I \%Experimental
-.IR \%Additions .
-.
-.
-.P
-In later years, many people worked with the operating system
-.FONT CI Multics R .
-.
-There
-.FONT CI RUNOFF
-was further developed.
-.
-.
-.P
-There is a good documentation of 1973 titled
-.FONT CI "Larry Barnes \(em RUNOFF: \
-A Program for the Preparation of Documents" R .
-.
-The
-.FONT CI RUNOFF
-was here further developed.
-.
-We use this document as well.
-.
-.
-.P
-Another good document comes from 1974 at the
-.FONT CR "DEC RSTS" R .
-.
-It is titled
-.FONT CI "RUNOFF User's Guide" R .
-.
-It contains the best description of the text lines.
-.
-We are glad to use that.
-.
-.
-.P
-The latest
-.FONT CI RUNOFF
-documentation is file
-.FONT CB RUNOFF.DOC
-from 
-.FONT CR PDP\-11
-at 1981, see
-.FONT CR "SEE ALSO" R .
-.
-The content of this document is also included in this document,
-although it has some errors.
-.
-.
-.P
-There is still more documentation by the
-.FONT CR "DEC PDP\-10 archive" R .
-.
-So far this information is not yet included in this document, but it
-will be done later on.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Early Environment 1963\-66 (CTSS)
-.\" --------------------------------------------------------------------
-.
-.FONT CI Saltzer
-originally worked on
-.IR \%MIT 's
-.I \%CTSS time-sharing operating
-.IR \%system .
-.
-There he had an editor
-.FONT CB TYPSET
-that he also documented in the documentation cited above.
-.
-This editor was an ancestor for
-.BR \%ed (@MAN1EXT@).
-.
-.
-.P
-To use his
-.FONT CI RUNOFF
-language, he programmed a tool that he called
-.FONT CB RUNOFF R .
-.
-.
-.P
-There is still an emulator and the old source files for
-.FONT CB RUNOFF
-and
-.FONT CB TYPSET
-at
-.nh
-.UR http://\:www.cozx.com/\:~dpitts/\:ibm7090.html 
-.FONT CR "IBM 7090 CTSS"
-.UE .
-.hy
-.
-.
-.\" --------------------------------------------------------------------
-.SS The original RUNOFF program 1963-66
-.\" --------------------------------------------------------------------
-.
-The original
-.FONT CB RUNOFF
-program is also documented in the documentation of 1966 above.
-.
-.
-.P
-.FONT CI Saltzer
-uses upper case
-.FONT CB RUNOFF
-to denote his program.
-.
-So we will also use 
-.FONT CB RUNOFF
-to refer to the original program of 1963-66.
-.
-.
-.P
-This program has mainly the task to adjust a printer of that time and
-then print a
-.FONT CI RUNOFF
-document with this configuration.
-.
-Today this does not make much sense, but some parts are still
-available in the options of
-.BR \%groff (@MAN1EXT@),
-but under different names.
-.
-So we will not build this ancient program, but we will document its
-old command line here.
-.
-A lower case program
-.FONT CB runoff
-will be something different.
-.
-.
-.P
-.FONT CB RUNOFF
-is a command used to type out files of the
-.FONT CI RUNOFF
-language in manuscript format.
-.
-.I Control words
-(command names) scattered in the text may be used to provide detailed
-control over the format.
-.
-Input files may be prepared by the context editor
-.FONT CB TYPSET
-which does not exist today.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Usage of RUNOFF Program
-\" --------------------------------------------------------------------
-.
-.SY RUNOFF
-.I \%filespec
-.RI [ "parameter \*[Ellipsis]" ]
-.YS
-.
-.
-.TP
-.I filespec
-is the primary name of a file to be typed out.
-.
-.TP
-.I parameter
-arguments are any number of the following parameters, in any order:
-.
-.
-.RS
-.
-.TP
-.FONT CB STOP
-Pause between pages.
-.
-.
-.TP
-.FONT CB NOWAIT
-Suppress the initial pause to load paper and the pause between pages
-(not necessary today).
-.
-.
-.TP
-.FONT CB PAGE I " n"
-Begin printing with the page numbered
-.IR n .
-.
-.
-.TP
-.FONT CB BALL I " n"
-Typewriter is using printing ball
-.IR n .
-If this parameter is omitted,
-.FONT CB RUNOFF
-assumes that the ball in use will properly print all
-.I CTSS characters
-in the file.
-.
-The number
-.I n
-is engraved on top of the printing ball.
-.
-.I CTSS characters
-not appearing on the ball being used will be printed as blanks, so
-that they may be drawn in.
-.
-This parameter does not make sense in our modern printers.
-.
-.RE
-.
-.
-.\" --------------------------------------------------------------------
-.SH BASIC RUNOFF LANGUAGE OF ALL TIMES
-.\" --------------------------------------------------------------------
-.
-Files written in the
-.FONT CI RUNOFF
-language are similar to modern
-.FONT CI roff
-files.
-.
-.
-.P
-They are both written in text mode.
-.
-So they can be manipulated with text editors like
-.BR emacs (1).
-.
-.
-.P
-In files written in the text languages
-.FONT CI RUNOFF
-or
-.FONT CI roff R ,
-there are command lines and text lines.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Basic Command Lines
-.\" --------------------------------------------------------------------
-.
-All lines beginning with a period (dot)
-.FONT CB .
-are command lines in both languages
-.FONT CI RUNOFF
-and
-.FONT CI roff R .
-.
-The period is followed by the name of the command (1 or 2 words of
-arbitrary length, later one even more words), optionally followed by 1
-or more arguments.
-.
-.
-.P
-The inventor
-.FONT CI Saltzer
-called the command name
-.IR "control word" ,
-but we keep using
-.I command name
-as was done in later times.
-.
-.
-.P
-In
-.FONT CI roff R ,
-lines starting with a single quote
-.FONT CB '
-are also command lines, but that's not true for the
-.FONT CI RUNOFF
-language by default.
-.
-.
-.P
-But in
-.FONT CI RUNOFF R ,
-the period
-.FONT CB .
-at the beginning of a line can be changed into any character.
-.
-This can be done by the command
-.FONT CB ".FLAG CONTROL" R .
-.
-So the starting period is only one possible special character.
-.
-But in this man\-page, we use the period before a command name,
-because it is the default and helps recognizing commands directly.
-.
-.
-.P
-In
-.FONT CI RUNOFF R ,
-the command names were quite long, sometimes consisting even of
-several words.
-.
-This is the same in the
-.FONT CI mom
-language in
-.FONT CI groff R .
-.
-.
-.P
-Moreover, the
-.FONT CI RUNOFF
-commands can be appreviated by defined 2 letters words (or 3 later on).
-.
-Later on, the
-.FONT CI "classical roff"
-languages used only the 2-letter abbreviations as requests; but
-.FONT CI groff
-expanded these to arbitrary length.
-.
-.
-.P
-In
-.FONT CI RUNOFF R ,
-each
-.FONT CI "control word"
-(command name) can be written in upper or lower case.
-.
-That comes from the time where the computers had only upper case input.
-.
-This was not taken into
-.FONT CI roff R ,
-because there were not enough 2-letter requests.
-.
-.
-.P
-In
-.FONT CI RUNOFF R ,
-comments could be appended to a command line, see section
-.FONT CB Comments R .
-.
-.
-.P
-Lines beginning with a period but having unrecognizable format are
-treated as error.
-.
-.
-.P
-No lines beginning with a dot are printed unless the preceding line
-was a
-.I command line
-with control name
-.FONT CB .LITERAL R .
-.
-Then the the line is output or printed as is, special characters are
-output without their special meaning.
-.
-.
-.P
-Abbreviations for command names are normally based on the first two
-letters of a one word command or the first letter of the first two
-words of a multi\-word command.
-.
-Later on 3-letter abbreviations where used for command names of 3
-words.
-.
-.
-.P
-An example of a
-.I "control line"
-(command line) with a single
-.I "control word"
-with 2 arguments is a long name with upper case
-.IP
-.FONT CB .COMMAND I " arg1 arg2"
-.P
-or the same name in lower case
-.IP
-.FONT CB .command I " arg1 arg2"
-.P
-or an abbreviation with upper case
-.IP
-.FONT CB .CO I " arg1 arg2"
-.P
-or the same abbreviation with lower case
-.IP
-.FONT CB .co I " arg1 arg2"
-.
-.
-.P
-Another example of a
-.I "control line"
-(command line) with 2
-.I "control words"
-with 1 argument is a long name with upper case
-.IP
-.FONT CB ".WORD1 WORD2" I " arg"
-.P
-or the same name in lower case
-.IP
-.FONT CB ".word1 word2" I " arg"
-.P
-or an abbreviation with upper case
-.IP
-.FONT CB .WW I " arg"
-.P
-or the same abbreviation in lower case
-.IP
-.FONT CB .ww I " arg"
-.
-.
-.P
-These
-.I "control words"
-were renamed to
-.I requests
-and
-.I macros
-later on in
-.FONT CI roff R .
-.
-.
-In the 1973 document, the words
-.I macros
-and
-.I formats
-are used, but there isn't any documentation for these terms.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Comments
-.\" --------------------------------------------------------------------
-.
-In
-.FONT CI roff R ,
-comments can be included by preceding the special character combination
-.FONT CB \[rs]\[rq] R .
-.
-.
-.P
-That was unknown in
-.FONT CI RUNOFF R .
-.
-There was only 1 method for including comments.
-.
-Command lines could be appended by comments.
-.
-.
-.P
-In the original
-.FONT CI RUNOFF
-language, a comment could be appended after the command arguments
-without using separators.
-.
-For example,
-.RS
-.FONT CB ".cmd1 cmd2 arg1 arg2 This is a comment"
-.RE
-.
-.
-.P
-In the newer
-.FONT CI RUNOFF
-languages (documented in 1974), they preceded the comments in command
-lines by the exclamation point (bang)
-.FONT CB ! R .
-.
-For example,
-.RS
-.FONT CB ".cmd1 cmd2 arg1 arg2 !This is a comment"
-.RE
-.
-.
-.\" --------------------------------------------------------------------
-.SS Basic Text Lines
-.\" --------------------------------------------------------------------
-.
-All lines that are not command lines are text lines in both languages.
-.
-.
-.P
-There are 2 modes of text lines in
-.FONT CI RUNOFF R .
-.
-The newer mode had upper and lower case in the source file.
-.
-This was similar to
-.FONT CI roff R .
-.
-.
-.P
-In the
-.FONT CI CTSS
-computer (early 1960s), there were only upper case input hardware.
-.
-So the
-.FONT CI RUNOFF
-files had only upper case ASCII characters in the original
-.FONT CI RUNOFF
-language.
-.
-.
-.P
-As the printers could print in upper and lower case, there were
-special characters as case-shifters.
-.
-That was also used in late
-.FONT CI RUNOFF
-files.
-.
-This process is very different from
-.FONT CI roff R .
-.
-.
-.P
-In the following sections, only the upper case text lines are documented.
-.
-.
-.P
-In
-.FONT CI RUNOFF
-and
-.FONT CI roff R ,
-there are special character combinations that can change the handling
-of the text.
-.
-But these special characters are totally different in both languages.
-.
-.
-.P
-One or more
-.I blank lines
-are not printed, but mean a
-.IR "line break" .
-.
-This can also be reached by the
-.FONT CB .BREAK
-.IR "control word" .
-.
-.
-.P
-In
-.IR groff ,
-blank lines are printed as lines of their own.
-.
-This is not a paragraph break, because a line is bigger than a
-paragraph break.
-.
-.
-.P
-A text line that starts with one or more space characters means
-.IR "begin a new paragraph" .
-.
-.
-.P
-In
-.IR groff ,
-this will start a new line and inserts the space characters at the
-beginning of the line.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Appending several Lines in RUNOFF
-.\" --------------------------------------------------------------------
-.
-In the 1974 paper, it is documented that a command line can be
-appended by several text or command lines into a single line, each
-being separated by a
-.FONT CI semi-colon
-.FONT CB ; R .
-.
-.
-.P
-If the appended line is a command line, then it starts with a period.
-.
-That's regarded as enough for separation.
-.
-In this case, the separating semi\-colon can be omitted.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Default Conditions (modes) in RUNOFF
-.\" --------------------------------------------------------------------
-.
-The starting case-mode (for output or printing) is lower case.
-.
-Each text line starts with that mode.
-.
-.
-.P
-Usually the text is
-.I filled
-and
-.I justified
-as it is processed.
-.
-That is, the program
-.I fills
-a line by adding successive words from the source text until one more
-word would cause the right margin to be exceeded.
-.
-The line is then
-.I justified
-by making the word spacings larger until the last word in the line
-exactly meets the right margin.
-.
-.
-.P
-The user may occasionally wish to reproduce the source text exactly,
-which is done by disabling
-.I filling
-and
-.I justification
-or by use of the
-.FONT CR .LITERAL
-command.
-.
-The program may be set to
-.I fill
-but not
-.IR justify ,
-in which case the output will be normal except that lines will not be
-justified to the right margin.
-.
-The program may also be set to
-.I justify
-but not
-.IR fill ,
-although this would probably produce peculiar results and is not
-recommended.
-.
-.
-.P
-When the
-.I fill mode
-is on, spaces and carriage returns occurring in the source text are
-treated only as word separators.
-.
-Multiple separators are ignored.
-.
-.
-.P
-Some of the commands cause a BREAK in the output.
-.
-A
-.I break
-means that the current line is output without justification, and the
-next word goes at the beginning of the next line.
-.
-This occurs at the end of paragraphs.
-.
-.
-.P
-The program will advance to new pages as necessary, placing the title
-(if given) and the page number at the top of each page.
-.
-The user may call explicitly for a
-.I page advance
-where desired, and may inhibit the occurrence of a
-.I page advance
-within specified material.
-.
-.
-.P
-By the documentation of 1974 and 1981, some special characters in text
-lines are initially disabled:
-.FONT CB < R " (" CB CAPITALIZE R ),
-.FONT CB > R " (" CB INDEX R ),
-.FONT CB = R " (" CB HYPHENATE R ),
-and
-.FONT CB % R " (" CB OVERSTRIKE R ).
-.
-.
-.P
-The other special characters seem to be enabled by default.
-.
-These should be:
-.FONT CB . R " (" CB CONTROL  R ),
-.FONT CB ! R " (" CB ENDFOOTNOTE R ),
-.FONT CB ^ R " (" CB UPPERCASE R ),
-.FONT CB \[rs] R " (" CB LOWERCASE R ),
-.FONT CB & R " (" CB UNDERLINE R ),
-.FONT CB # R " (" CB SPACE R ),
-and
-.FONT CB _ R " (" CB QUOTE R ).
-.
-.
-.P
-This can be changed by the commands
-.RS
-.FONT CB .FLAGS I " <mode>"
-.RE
-(enabling) and
-.RS
-.FONT CB ".NO FLAGS" I " <mode>"
-.RE
-(disabling).
-.
-Also, each special character can be set to another character by the
-.RS
-.FONT CB .FLAGS I " <mode> <some_character>"
-.RE
-command.
-.
-.
-.P
-The following informs about the
-.I <mode>
-arguments:
-.
-.
-.TP
-.FONT CB CONTROL
-default:
-.FONT CI period
-on first column (start command line):
-.FONT CB .
-.
-.TP
-.FONT CB ENDFOOTNOTE
-default:
-.FONT CI "exclamation character"
-on first column (end of footnote):
-.FONT CB !
-.
-.TP
-.FONT CB UPPERCASE
-upper case (single character) and case lock (2 characters), default:
-.FONT CB ^
-.
-.TP
-.FONT CB LOWERCASE
-lower case (single character) and case lock (2 characters), default:
-.FONT CB \[rs]
-.
-.TP
-.FONT CB UNDERLINE
-underlining word witout spaces, default:
-.FONT CB &
-.
-.TP
-.FONT CB SPACE
-quoted space (no filling and justifying), default:
-.FONT CB #
-.
-.TP
-.FONT CB QUOTE
-quoting character (output special character without specialization),
-default:
-.FONT CB _
-.
-.TP
-.FONT CB CAPITALIZE
-upper case for next character, default:
-.FONT CB <
-.
-.TP
-.FONT CB INDEX
-set following word into index, default:
-.FONT CB >
-.
-.TP
-.FONT CB OVERSTRIKE
-superimpose the surrounding characters, default:
-.FONT CB %
-.
-.TP
-.FONT CB HYPHENATE
-default:
-.FONT CB =
-.
-.TP
-.FONT CB ALL
-all but the 1st column characters
-.FONT CB .
-and
-.FONT CB !
-.
-.TP
-.FONT CB null
-same as
-.FONT CB ALL
-.
-.
-.P
-The following special characters are only documented in 1981, but it
-is not clear if they are initially enabled.
-.
-Also no
-.I <mode>
-for
-.FONT CB .FLAGS
-are documented:
-.FONT CB { R ,
-.FONT CB } R ,
-.FONT CB | R ,
-and
-.FONT CB Ctrl-N R .
-.
-.
-.P
-.FONT CI RUNOFF R 's
-ability to change most special characters is unique.
-.
-.FONT CI roff
-cannot do that.
-.
-.
-.\" --------------------------------------------------------------------
-.SH UPPER CASE TEXT LINES
-.\" --------------------------------------------------------------------
-.
-The original
-.FONT CI RUNOFF
-text lines are different from the
-.FONT CI roff
-language.
-.
-.
-.P
-As the early
-.FONT CI CTSS
-computers could only produce upper case characters as input, the text
-lines look very strange today.
-.
-This wasn't documented in the documentation of the 1960s.
-.
-But there are good documentations of 1974 and 1981 which contain also
-the old style.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Case Changing of Text Lines
-.\" --------------------------------------------------------------------
-.
-In this section, the specification of case for files prepared on an
-upper case terminal is documented.
-.
-There are special characters that in printing act as case-shifters for
-ASCII characters into lower (ASCII code 97 to 122 decimal) or upper
-case (ASCII code 65 to 90 decimal).
-.
-.
-.P
-The lower case mode seems to be the default mode.
-.
-Also, according to existing old
-.FONT CI RUNOFF
-files, each text line starts with this default mode.
-.
-.
-.TP
-.FONT CI "single circumflex " CB ^
-The following ASCII character is shifted to
-.FONT CI "upper case" R .
-.
-The following from the document of 1981 seems to be wrong:
-.
-(It is also used to lock the
-.I case mode
-in
-.IR "upper case" ,
-and the
-.I underline mode
-to
-.UL "underline all text" ).
-
-.
-.
-.TP
-.FONT CI "single back\-slash " CB \[rs]
-The following ASCII character is shifted into lower case.
-.
-The following from the document of 1981 seems to be wrong:
-.
-(It is also used to lock the
-.I case mode
-in
-.IR "lower case" ,
-and disable underlining.)
-.
-.
-.TP
-.FONT CI "double circumflex " CB ^^
-The case mode is shifted into upper case.
-.
-.
-.TP
-.FONT CI "double back\-slash " CB \[rs]\[rs]
-The case mode is shifted into lower case.
-.
-.
-.P
-A common example with starting mode in lower case for these 4 special
-characters is:
-.
-.P
-.RS
-^HERE IS A ^SAMPLE ^SENTENCE IN ^^UPPER CASE\\ AND LOWER CASE.
-.RE
-.
-.P
-is printed as:
-.
-.RS
-Here is a Sample Sentence in UPPER CASE and lower case.
-.RE
-.
-.
-.\" --------------------------------------------------------------------
-.SS Further special Characters in Text Lines
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CI "ampersand " CB &
-This is used for underscoring the next following character.
-.
-For example:
-.
-.RS
-.P
-.RS
-&s&o&f&t&w&a&r&e
-.RE
-.
-.P
-becomes:
-.RS
-.UL software
-.RE
-.
-.P
-in the output or printing.
-.RE
-.
-.
-.TP
-.FONT CI "circumflex and ampersand " CB ^&
-This is used for underscoring all following characters except for
-blanks.
-.
-One could say that by this character combination the underline mode is
-put on.
-.
-.
-.TP
-.FONT CI "back\-slash and ampersand " CB \[rs]&
-This is used for stopping the underscoring.
-.
-One could say that by this character combination the underline mode is
-put off.
-.
-.
-.RS
-.P
-For example:
-.RS
-^&PLATO\[rs]& was a very ^&wise \[rs]&man.
-.RE
-becomes
-.RS
-.UL PLATO
-was a very
-.UL wise
-man.
-.RE
-.
-.
-.P
-In
-.FONT CI groff R ,
-spaces are not underlined as well.
-.
-.RE
-.
-.
-.TP
-.FONT CI "number sign " CB #
-.FONT CI RUNOFF 
-interprets this character as a
-.FONT CI "quoted space" R .
-.
-It outputs exactly 1 space character, it is not justified or filled.
-.
-It cannot end a line.
-.
-In the text it is not treated as a
-.IR "word separator" .
-.
-.
-.TP
-.FONT CI "less\-than " CB <
-This character preceding a word capitalizes the entire word up to the
-first space character.
-.
-This is the same as preceding the word with
-.FONT CB ^^
-and ending it with
-.FONT CB \[rs]\[rs] R .
-.
-For example, if the current case mode is lower case, the following
-text line
-.RS
-.RS
-.FONT CB "<DIGITAL OF ^MAYNARD, <MA"
-.RE
-becomes
-.RS
-.FONT CB "DIGITAL of Maynard, MA"
-.RE
-in the output (printing).
-.
-This special character is initially disabled.
-.
-It can be activated by the command
-.FONT CB .FLAGS R .
-.
-.RE
-.
-.
-.TP
-.FONT CI "greater\-than " CB >
-This character enters the immediately following word (up to the first
-space character) into the index, including all case shifters in the
-word.
-.
-This special character is initially disabled.
-.
-It can be enabled by the command
-.FONT CB .FLAGS R .
-.
-.
-.TP
-.FONT CI "percent " CB %
-This is for
-.FONT CI superimposition
-of the surrounding characters, one character over the other.
-.
-For example, the combination
-.FONT CB /%=
-overstrikes the 2 characters
-.FONT CI slash
-and
-.FONT CI equal
-into the character
-.FONT CB \[!=]
-(unequal).
-.
-In underlining, superimposition cannot be done.
-.
-This special character is initially disabled.
-.
-So a percent character is output as is.
-.
-This character can be enabled by the command
-.FONT CB .FLAGS R .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Special Characters in Text Lines of 1981
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB = CI " equals\-sign " I  "\[em] hypenation disable"
-If
-.FONT CB ".FLAGS HYPHENATE"
-has been engaged, the
-.I equals
-character
-.FONT CB =
-used to disable
-.I hyphenation
-for the word it precedes.
-.
-.
-.TP
-.FONT CB { CI " left\-brace " I "\[em] Reverse half\-linefeed"
-If the output device type is no
-.FONT CB N R ,
-then the
-.I left
-and
-.I right braces
-are used for
-.I superscripting
-and
-.IR subscripting .
-.
-The
-.I left\-brace
-.FONT R ( CB { CR " 173 octal" R )
-produces a
-.IR "reverse half\-linefeed" .
-When combined with the
-.I right brace
-.FONT R ( CB } CR " 175 octal" R )
-scripting is created; e.g.
-.FONT CB {super}
-becomes
-.EQ
-"" sup superscript
-.EN
-and
-.FONT CB }sub{
-becomes
-.EQ
-"" sub subscript
-.EN
-.
-.
-.TP
-.FONT CB } CR " right\-brace " I "forward half\-linefeed"
-As described above, the
-.I right brace
-.FONT R ( CB } CR " 175 octal" R )
-when coupled with the
-.I left brace
-will produce scripting.
-.
-This will only occur when a scripting output device is selected.
-.
-.
-.TP
-.FONT CB | CR " vertical\-bar " I "Engage/disengage alternate character set"
-The
-.I vertical bar
-.FONT R ( CB | R , CR " 174 octal" R )
-acts as an on/off switch.
-.
-It will alternately transmit a
-.I shift\-out
-and a
-.I shift\-in
-character to change the selected character set; e.g.
-.FONT CB |ABC|
-becomes
-.FONT CI Ctrl\-N CB ABC CI Ctrl\-O R .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Escape Sequences in Text Lines
-.\" --------------------------------------------------------------------
-.
-The
-.FONT CI "escape character"
-in
-.FONT CI RUNOFF
-(also called
-.FONT CI "quote character" R )
-is the
-.FONT CI "sub character " CB _ R .
-.
-Using this character as a prefix before a special character, outputs
-the special character as it is without its speciality, no formatting
-is done by it.
-.
-.
-.TP
-.FONT CB _^
-outputs the special character
-.FONT CB ^
-.
-.
-.TP
-.FONT CB _\[rs]
-outputs the special character
-.FONT CB \[rs]
-.
-.
-.TP
-.FONT CB _&
-outputs the special character
-.FONT CB &
-.
-.
-.TP
-.FONT CB _#
-outputs the special character
-.FONT CB #
-.
-.
-.TP
-.FONT CB _<
-outputs the special character
-.FONT CB <
-.
-.
-.TP
-.FONT CB _>
-outputs the special character
-.FONT CB >
-.
-.
-.TP
-.FONT CB _%
-outputs the special character
-.FONT CB %
-.
-.
-.TP
-.FONT CB __
-outputs the special character
-.FONT CB _
-.
-.
-.\" --------------------------------------------------------------------
-.SH COMMAND NAMES (CONTROL WORDS) IN THE ORIGINAL RUNOFF LANGUAGE OF 1966
-.\" --------------------------------------------------------------------
-.
-The documentation for
-.I "control words"
-in this paragraph are taken from the
-.FONT CI RUNOFF
-documentation of 1966.
-.
-Often this documentation refers to the
-.FONT CB RUNOFF
-program that doesn't exist any more.
-.
-When the
-.FONT CI RUNOFF
-language will be implemented for
-.BR \%groff (@MAN1EXT@)
-these documentations must be adjusted.
-.
-.
-.TP
-.FONT CB .ADJUST
-.TQ
-.FONT CB .AD
-Enable
-.I fill
-mode.
-.
-The next line is the first one affected.
-.
-This is the default mode.
-.
-.
-.TP
-.FONT CB .APPEND I " file"
-.TQ
-.FONT CB .AP I " file"
-Take as the next input line the first line of
-.IR \%file .
-.
-Note that the whole of 
-.I \%file
-is appended, and that the appending is an irreversible process \[em] that
-is, once
-.FONT CB RUNOFF
-encounters the
-.FONT CB .APPEND
-.I "control line"
-it will switch to the file
-.I \%file
-and continue from the first line of
-.IR \%file .
-.
-All lines following the
-.FONT CB .APPEND
-.I "control line"
-will not be processed by
-.FONT CB RUNOFF R .
-.
-The file
-.I \%file
-may, of course, itself call for appending of still another file, and
-so on.
-.
-.
-.TP
-.FONT CB ".BEGIN PAGE"
-.TQ
-.FONT CB .BP
-Print out this page, start next line on a new page.
-.
-.
-.TP
-.FONT CB .BREAK
-.TQ
-.FONT CB .BR
-The lines before and after the
-.FONT CB .BREAK
-.I "control word"
-will not be run together by the
-.FONT CI fill
-mode of operation.
-.
-.
-.TP
-.FONT CB .CENTER
-.TQ
-.FONT CB .CD
-The following line is to be centered between the left and right
-margins.
-.
-.
-.TP
-.FONT CB ".DOUBLE SPACE"
-.TQ
-.FONT CB .DS
-Copy is to be double spaced.
-.
-This mode  takes  effect after the next line.
-.
-.
-.TP
-.FONT CB .FILL
-.TQ
-.FONT CB .FI
-Enable
-.IR "fill mode" .
-.
-That means: Lengthen short lines by moving words from the following
-line; trim long lines by moving words to the following line.
-.
-This is the default mode.
-.
-.FONT CB .NOFILL
-disables the
-.I fill
-mode.
-.
-.
-.TP
-.FONT CB .HEADER I " word1 word2 \*[Ellipsis]"
-.TQ
-.FONT CB .HE I " word1 word2 \*[Ellipsis]"
-All of the line after the first blank is used as a header line, and
-appears at the top of each page, along with the page number, if
-specified.
-.
-.
-.TP
-.FONT CB ".HEADING MODE" I " arg"
-.TQ
-.FONT CB .HM I " arg"
-This
-.I control sequence
-alters the mode of the running head to that specified by the parameter
-.IR \%arg .
-.
-Any of the following parameters are allowed for
-.IR \%arg:
-.
-.
-.\"  --------------------------------------------------------------------
-.RS
-.
-.
-.TP
-.FONT CB CENTER
-The header will be centered on the page.
-.
-.
-.TP
-.FONT CB MARGIN
-The header will be adjusted against the right margin of the page.
-.
-.
-.TP
-.FONT CB FACING
-On even\-numbered pages, the header will be adjusted against the left
-margin, on odd numbered pages against the right.
-.
-.
-.TP
-.FONT CB OPPOSED
-The header will be adjusted against the opposite margin from the page
-number.
-.
-In the absence of a
-.FONT CB ".HEADING MODE"
-.IR "control sequence" ,
-the default option is
-.FONT CB OPPOSED R .
-.
-.
-.RE
-.\"  --------------------------------------------------------------------
-.
-.
-.TP
-.FONT CB .INDENT I " n"
-.TQ
-.FONT CB .IN I " n"
-The argument
-.I \%n
-is a number.
-.
-Set the number of spaces to be inserted at the beginning of each line
-to
-.IR \%n .
-.
-Indent is preset to 0.
-.
-.
-.TP
-.FONT CB ".LINE LENGTH" I " n"
-.TQ
-.FONT CB .LL I " n"
-The argument
-.I \%n
-is a positive number.
-.
-Set the line length to
-.IR \%n .
-.
-The line length is preset to 60.
-.
-.
-.TP
-.FONT CB .LITERAL
-.TQ
-.FONT CB .LI
-The following line is not a
-.IR "control word" ,
-despite the fact that it begins with a period.
-.
-.
-.TP
-.FONT CB .NOFILL
-.TQ
-.FONT CB .NF
-Disable
-.IR "fill mode" .
-.
-That means: Print all lines exactly as they appear without right
-adjustment or filling out.
-.
-In
-.I NOFILL
-mode each input line produces one output line; further blank lines are
-output in this mode.
-.
-Use the
-.FONT CB .FILL
-.I control word
-to restart
-.IR filling .
-.
-.
-.TP
-.FONT CB .NOJUST
-.TQ
-.FONT CB .NJ
-Disable
-.IR "fill mode" .
-.
-.
-.TP
-.FONT CB ".ODD PAGE"
-.TQ
-.FONT CB .OP
-This
-.I "control word"
-causes the current page to be printed out, and the next page to be
-numbered with the next higher odd page number.
-.
-.
-.TP
-.FONT CB .PAGE R " [" I n R ]
-.TQ
-.FONT CB .PA R " [" I n R ]
-Print page numbers.
-.
-(The first page is not given a page number.
-.
-It has instead a two\-inch top margin.
-.
-See also
-.FONT CB "Manuscript Conventions" R ,
-below.)
-.
-If argument
-.I \%n
-is present, insert a page break and number the next page
-.IR \%n .
-Note that
-.FONT CB RUNOFF
-does not output or print completely empty pages.
-.
-.
-.TP
-.FONT CB ".PAGING MODE" I " arg1 arg2 \*[Ellipsis]"
-.TQ
-.FONT CB .PM I " arg1 arg2 \*[Ellipsis]"
-This
-.I control sequence
-alters the mode of page numbering to that specified by the arguments.
-.
-The arguments may be in any order, and must be selected from the
-following list:
-.
-.
-.\"  --------------------------------------------------------------------
-.RS
-.
-.
-.TP
-.FONT CB MARGIN
-Page numbers will be adjusted against the right margin.
-.
-.
-.TP
-.FONT CB FACING
-Odd page numbers are adjusted against the right margin, even page
-numbers are adjusted against the left margin.
-.
-.
-.TP
-.FONT CB CENTER
-Page numbers are centered between the right and left margin.
-.
-.
-.TP
-.FONT CB TOP
-Page numbers are placed on the fourth line from the top of the page.
-.
-.
-.TP
-.FONT CB BOTTOM
-Page numbers are placed on the fourth line from the bottom of the
-page.
-.
-.
-.TP
-.FONT CB OFF
-Page numbers are discontinued.
-.
-.
-.TP
-.FONT CB PREFIX I " \(dqstring\(dq"
-The string of characters between quotation marks is prefixed to the
-page number.
-.
-The quotation marks may be next to each other, in which case no prefix
-is used.
-.
-.
-.TP
-.FONT CB ROMANU
-Page numbers will be printed in upper case Roman numerals.
-.
-.
-.TP
-.FONT CB ROMANL
-Page numbers will be printed in lower case Roman numerals.
-.
-.
-.TP
-.FONT CB ARABIC
-Page numbers will be printed in Arabic.  (This is the normal mode.)
-.
-.
-.TP
-.FONT CB SET I " n"
-Set the next page number to be the positive number
-.IR \%n .
-.
-.
-.TP
-.FONT CB SKIP I " n"
-Skip
-.I \%n
-page numbers.
-.
-.
-.P
-If in a single use of
-.FONT CB ".PAGING MODE"
-several arguments specify competing functions, the last one specified
-takes precedence.
-.
-When the
-.FONT CB ".PAGING MODE"
-sequence appears in text at point A, all text up to A (and probably
-some text after A) will appear on a page controlled by the previous
-paging mode.
-.
-The new
-.I paging mode
-will take effect on the next page.
-.
-Then there is no danger of getting page numbers both at the top and
-bottom of the same page.
-.
-.
-.P
-Use of the
-.FONT CB .TOP
-parameter may conflict with the
-.I \%heading
-.IR \%mode .
-.
-If a heading and a page number should be printed in the same column,
-the page number will take precedence.
-.
-In the absence of a
-.FONT CB ".PAGING MODE"
-.I control
-.IR sequence ,
-the default options are:
-.FONT CB "TOP MARGIN PREFIX \(dqPAGE\(dq" R .
-.
-.
-.RE
-.\"  --------------------------------------------------------------------
-.
-.
-.TP
-.FONT CB ".PAPER LENGTH" I " n"
-.TQ
-.FONT CB .PL I " n"
-This
-.I control word
-is used for running off a documentation file on non\-standard paper.
-.
-The number
-.I \%n
-is a line count, figured at 6 lines per inch.
-.
-If this
-.I control word
-is not given,
-.I n
-is assumed to be 66, for 11\-inch paper.
-.
-.
-.TP
-.FONT CB ".SINGLE SPACE"
-.TQ
-.FONT CB .SS
-Copy is to be single spaced.
-.
-This mode takes effect after the next line.
-.
-(The normal mode is single space.)
-.
-.
-.TP
-.FONT CB .SPACE R " [" I n R ]
-.TQ
-.FONT CB .SP  R " [" I n R ]
-Insert
-.I \%n
-vertical spaces (carriage returns) in the copy.
-.
-If
-.I \%n
-carries spacing to the bottom of a page, spacing is stopped.
-.
-If
-.I \%n
-is absent or 0, one space is inserted.
-.
-.
-.TP
-.FONT CB .UNDENT I " n"
-.TQ
-.FONT CB .UN I " n"
-In an indented region, this
-.I control word
-causes a break, and the next line only will be indented n spaces fewer
-than usual.
-.
-This
-.I "control word"
-is useful for typing indented numbered paragraphs.
-.
-.
-.\" --------------------------------------------------------------------
-.SH RUNOFF ADDITIONS 1973
-.\" --------------------------------------------------------------------
-.
-Here are described only the additional
-.I control words
-that are documented in the 1973 documentation.
-.
-.\" --------------------------------------------------------------------
-.SS Formats
-.\" --------------------------------------------------------------------
-.
-.
-.TP
-.FONT CB .FORMAT I " name"
-This command causes subsequent text to be output under the control of
-tne specified format (see below at
-.FONT CB ".DEFINE FORMAT" R ).
-.
-Each following logical line will be fit into the format until a
-.FONT CB .FILL
-or
-.FONT CB .NOFILL
-command 1s encountered.
-.
-.
-.TP
-.FONT CB ".DEFINE FORMAT" I " <name> <pos> <field_ definition> \
-\*[Ellipsis]"
-.TQ
-.FONT CB ".END FORMAT"
-These commands define a format for use in producing tables, etc.
-.
-.
-.RS
-.
-.
-.TP
-.I <name>
-identifies the format.
-.
-It can be activated by the
-.FONT CB .FORMAT
-.IR command .
-.
-.
-.TP
-.I <pos>
-is the position and may be one of
-.FONT CB .LEFT R ,
-.FONT CB .RIGHT R ,
-or
-.FONT CB .CENTER R ,
-and determines the overall positlon of the format with respect to the
-margins.
-.
-.
-.TP
-.I <field_definition>
-There can be several arguments of this type.
-.
-Each has the form:
-.
-.
-.RS
-.
-.FONT CI <type> CB ( CI "<letter> \*[Ellipsis] <letter>" CB )
-.
-.P
-where the
-.FONT CI <type>
-is one of
-.
-.TP
-.FONT CB L
-for left,
-.
-.TP
-.FONT CB R
-for riqht,
-.
-.TP
-.FONT CB C
-for center,
-.
-.TP
-.FONT CB F
-for
-.FONT CI fill R ,
-or
-.FONT CB J
-for
-.FONT CI justify R .
-.
-.
-.P
-The first three types define fixed fields; the text to be formatted
-must fit within the allocated space.
-.
-The latter types define variable fields; the text will be handled as
-in normal fill mode processing.
-.
-.
-.P
-A picture showing the manner in which text should be output follows
-the
-.FONT CB ".DEFINE FORMAT"
-command; following the picture should be an
-.FONT CB ".END FORMAT"
-command.
-.
-The following lines give an example:
-.
-.
-.RS
-.  ft CB
-.  nf
-.  nh
-.    nop ".DEFINE FORMAT SUMMARY L(A) F(C) C(B)"
-.    nop "AAAA	CCCCCCCCCCCCCCCCCCCCCCCCC	BBBBBBB"
-.    nop "	CCCCCCCCCCCCCCCCCCCCCCCCC		"
-.    nop ".END FORMAT"
-.  hy
-.  fi
-.  ft
-.RE
-.
-.
-.P
-The first field of text is left justified; the second is centered; the
-third is subjected to
-.I fill mode
-processing without justification.
-.
-After the first line of output is generated using this format, all
-subsequent lines are produced using the last picture 1ine.
-.
-(Strictly speaking the third line is unnecessary.)
-.
-.
-.P
-Text for formatted processing consists of a logical line (or
-paragraph).
-.
-Each field except the last must be separated by
-.IR tab .
-.
-The
-.I tab character
-is displayed here as backslash character
-.FONT R ( CB \[rs] R ).
-.
-.
-.P
-The first field of text is
-.FONT CB A R ,
-the second
-.FONT CB B R ,
-etc.
-.
-Typical input for our example might be:
-.
-.
-.RS
-.nf
-.nh
-|A\\YES\\/THIS IS SOME TEXT
-TO BE FILLED.
-.hy
-.fi
-.RE
-.
-.
-.P
-The characters 1n the picture lines were 1nterpreted as follows.
-.
-Contiguous sequences of letters determine the fie1d positions;
-non\-alphabetic characters are output literally.
-.
-(Note:
-.FONT CB Q.QQ
-wi11 not work, put the period
-.RB \[dq] . \[dq]
-in the text.
-.
-A sequence of characters written between double quotes is considered
-literal text.
-.
-The
-.I double quotes
-are not output, and there is no way to use
-.I double quote
-as a
-.IR literal .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Hyphenation Processing
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .HYPHENATE
-Enable
-.IR "hyphenation mode" .
-.
-This is the default when starting up.
-.
-The
-.FONT CB RUNOFF
-program used a small
-.I glossary
-for splitting.
-.
-In
-.I hyphenation mode
-.FONT CB RUNOFF
-would try to find a word 1n the glossary which is the same (except for
-the endings
-.FONT CB \-S R ,
-.FONT CB \-ES R ,
-.FONT CB \-ED R ,
-and
-.FONT CB \-E R )
-as the word at the end of the line of text.
-.
-When running in
-.BR groff (1)
-there are
-.I glossaries
-being much more complete than in
-.BR RUNOFF .
-.
-.
-.TP
-.FONT CB .NOHYPHEN
-Disable
-.IR "hyphenation mode" .
-.
-.
-.TP
-.FONT CB .GLOSSARY I " word"
-This command inserts words into the
-.I glossary
-for use in
-.IR hyphenation .
-.
-Each word should have the form
-.FONT CB hy\[hy]phen\[hy]ate
-and be separated by spaces.
-.
-.
-.TP
-.FONT CB ".HYPHENATION BREAK" I " n"
-This command set the parameter which determines the allowable number
-of spaces to te inserted in a line before
-.FONT CB RUNOFF
-tried to hyphenate the last word.
-.
-Each space counts ten points.
-.
-If more than
-.I n
-points per word would have to be inserted, then
-.I hyphenation
-will be attempted.
-.
-The initial setting of this parameter is 5 (one\-half space per word).
-.
-.
-.\" --------------------------------------------------------------------
-.SS Margin Controls
-.\" --------------------------------------------------------------------
-.
-There are two types of margins involved in
-.FONT CI RUNOFF R .
-.
-.
-.TP
-(1)
-The physical margins.
-.
-These are determined by the nature of the printing device.
-.
-The margins outline the area where it is physically possible to print
-characters.
-.
-.
-.TP
-(2)
-.
-The logical margins.
-.
-These can be set bv the user as he wishes.
-.
-(Limits are imposed by the physical margins.)
-.
-They are initialized for standard 8.5\[dq] by 11\[dq] printing.
-.
-.
-.P
-Commands concerning vertical and horizontal margins are:
-.
-.
-.TP
-.FONT CB ".PAGE LAYOUT TM, EM, TOL"
-This sets the vertical logical margins and vertical tolerence.
-.
-Parameters are top margin, bottom margin and tolerance.
-.
-The tolerance is used to determine where to break between pages on
-page overflows.
-.
-If
-there is a line break within
-.I TCL lines
-of the bottom,
-.FONT CB RUNOFF
-will break the page there; otherwise it will fill the page completely.
-.
-.
-.TP
-.FONT CB ".LINE LAYOUT LM, RM, NO, CS"
-This sets the logical left and right margin, the number of columns,
-and the number of spaces to insert between columns.
-.
-These margins are used for the page headings.
-.
-To adjust the relative
-text position, use the subsequent commands.
-.
-.
-.TP
-.FONT CB ".REDUCE MARGIN LM, RM"
-.TQ
-.FONT CB ".EXPAND MARGIN LM, RM"
-.TQ
-.FONT CB ".END REDUCTION"
-These commands enable the user to indent a certain portion of his text
-using the first command, or
-.FONT CB .UNDENT
-his text using the second command.
-.
-In either case the original margins are restored by the third command.
-.
-The use of several
-.FONT CB ".REDUCE MARGIN"
-commends before the corresponding
-.FONT CB ".END REDUCTION"
-commands succesively indents the text more, and more.
-.
-Thus these commands are 1ike brackets (i.e. recursive).
-.
-.FONT CB LM
-is added to the left logical margin and
-.FONT CB RM
-is subtracted from the right logical margin in the first command.
-.
-Just
-the opposite is done on the second command.
-.
-Negative numbers are permitted.
-.
-These commands do not effect the position of page headings.
-.
-.
-.TP
-.FONT CB ".LAYOUT PLM, PRM, PTM, PBM, LL, LO"
-This command defines the physical margins in the followinq complex
-manner.
-.
-(It should only be used for non\-standard devices, normally this
-command should not be necessary.)
-.
-The parameters are the physical left margin (in spaces), the physical
-right margin, the physical top 1ine, the physical bottom line, the
-line lenqth, and line origin.
-.
-The first four parameters define the physical 1imits of the printing
-device.
-.
-The final two parameters define the length of the logical line and its
-origin with respect to the left edge of the paper.
-.
-Printing starts at column
-.FONT CB "LO + LM" R ,
-and ends at
-.FONT CB "LO + RM" R ,
-where
-.FONT CB LM
-and
-.FONT CB RM
-are the logical margins established by
-.FONT CB ".LINE LAYOUT" R .
-.
-When using the
-.FONT CI "facing feature"
-(see
-.FONT CB ".PAGING MODE" R ),
-the logical left margin is
-.FONT CB "LL \[em] RM"
-on even pages, and the right margin is
-.
-.FONT CB "LL \[em] LM" R .
-.
-The parameters for the layout command must satisfy:
-.
-.RS
-.RS
-.nh
-.nf
-.ft CB
-.nop "min(LO + LL \[em] PLM, PRM \[em] LO) > max(PLM \[em] LO, \
-LO + LL \[em] PRM)\f[],\f[CB]"
-.nop LL > 25\f[], and \f[CB]PBM \[em] PTM > 6\f[]
-.fi
-.hy
-.RE
-.
-.
-.P
-This command sets
-.FONT CB LM
-to 15,
-.FONT CB RM
-to
-.FONT CB "LL \[em] 10" R ,
-.FONT CB TM
-to
-.FONT CB PTM R ,
-and
-.cb BM
-to
-.FONT CB "PBM \[em] 6" R .
-.
-(These margin settings produce the standard 1.5 inch left, and 1 inch
-right, too, and bottom margins.)
-.
-.RE
-.
-.
-.P
-Initially
-.FONT CB RUNOFF
-sets the margins for
-.I teletype
-output to:
-.
-.
-.RS
-.RS
-.nh
-.nf
-.ft CB
-.nop .LAYOUT 6, 89, 6, 66, 8S, 0
-.nop .LINE LAYOUT 15, 75
-.nop .FILL
-.ft
-.fi
-.hy
-.RE
-.RE
-.
-.
-.P
-The printer layout is:
-.
-.RS
-.RS
-.nh
-.nf
-.ft CB
-.nop ".layout 5, 137, 6, 66, 85, 15"
-.nop ".page layout 6, 60, 4"
-.ft
-.fi
-.hy
-.RE
-.RE
-.
-.P
-The logical margins must satisfy:
-.
-.RS
-.RS
-.nh
-.nf
-.ft CB
-.nop min(LL, PRM \[em] LO, LO \[em] LL \[em] PLM) >= RM >
-.nop "     LM >= max(0, PLM \[em] LO, LO + LL \[em] PRM)" \f[],\f[CB]
-.nop "PBM >= BM > TM >= PTM" "\f[], and\f[CB]"
-.nop BM \[em] TM > TOL\f[].
-.fi
-.hy
-.RE
-.RE
-.
-.
-.\" --------------------------------------------------------------------
-.SS Paragraph Formatting
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB ".PARAGRAPH SPACING" I " n"
-.
-This specifies how many lines are to be inserted between paragraphs.
-.
-Initial setting = 1.
-.
-.
-.TP
-.FONT CB ".PARAGRAPH INDENTATION" I " n"
-This specifies how many additional spaces to insert at the beginning
-of a paragraph.
-.
-Initial setting = 5.
-.
-.
-.TP
-.FONT CB ".PARAGRAPH UNDENTATION" I " n"
-This command is the same as
-.FONT CB ".PARAGRAPH INDENTATION" I " \-n" R .
-.
-That is,
-.I n
-fewer spaces are inserted at the beginning of the paragraph.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Special Line Justification and Control
-.\" --------------------------------------------------------------------
-.
-These commands pertain to the next logical line.
-.
-The end of the line should be designated with a break.
-.
-.
-.TP
-.FONT CB .CENTER
-.
-Center the next line.
-.
-.
-.TP
-.FONT CB .INDENT I " n"
-.
-Indent the next line
-.I n
-spaces.
-.
-If
-.I n
-is not provided, 5 is assumed.
-.
-.
-.TP
-.FONT CB .UNDENT I " n"
-.
-Start the next line
-.I n
-spaces to the left of the normal margin.
-.
-This command is the same as
-.FONT CB .INDENT I " \-n" R .
-.
-.
-.TP
-.FONT CB .MARGIN
-Justify the next 1ine against the right hand margin.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Heading and Paging
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .HEADER I " XXXXXXX"
-.FONT CB RUNOFF
-accepts a heading to go on the first line of
-each paqe.
-.
-The heading strinq is assured to start at the first non\-blank
-character after thd control word and end at carriage return.
-.
-.
-.TP
-.FONT CB ".HEADING MODE" I " <param>"
-.I <param>
-determines the position of the heading on the 11ne.
-.
-.I <param>
-may be any of the following.
-.
-.
-.RS
-.
-.TP
-.FONT CB CENTER
-The header will be centered on the 1ine.
-.
-.
-.TP
-.FONT CB MARGIN
-The header will be adjusted against the riqht margin.
-.
-.
-.TP
-.FONT CB PAGING
-On even numbered pages the header is adjusted against the right
-margin.
-.
-On odd pages it is adjusted against the left mergin.
-.
-.
-.TP
-.FONT CB OPPOSED
-The header will be adjusted against the opposite margin from the
-page numter.
-.
-This is the initial mode.
-.
-.RE
-.
-.
-.TP
-.FONT CB ".PAGING MODE" I " <param>"
-.
-This command determines the placing of the page number.
-.
-All parameters are optional.
-.I <param>
-may be anyone or more of the following oommands.
-.
-In case of conflict the latest command wins.
-.
-.RS
-.
-.TP
-.FONT CB CENTER
-The page numbers are centered between the logical margins.
-.
-.TP
-.FONT CB MARGIN
-The page number is adjusted against the right margin.
-.
-.TP
-.FONT CB FACING
-On even numbered pages the number will be adjusted against the right
-margin.
-.
-On odd numbered pages tne number will be adjusted against the
-left margin.
-.
-.TP
-.FONT CB TOP
-Page numbers are placed on the first line.
-.
-.TP
-.FONT CB BOTTOM
-Page numbers are placed on the last line.
-.
-.TP
-.FONT CB OFF
-Printing page numbers is discontinued.
-.
-.TP
-.FONT CB .PREFIX I " <string>"
-.TQ
-.FONT CB .SECTION I " <string>"
-.TQ
-.FONT CB .SUFFIX I " <string>"
-The strings of characters between quotation marks are used to form the
-page string, which has the form:
-.
-.RS
-.I <prefix><section><page number><suffix>
-.
-.P
-Any or all of these strings mav be null.
-.
-The section string is considered to be part of the page number for
-purposes of indexing.
-.
-.RE
-.P
-Initial mode is:
-.
-.RS
-.RS
-.ft CB
-.nop ".PAGING MODE TOP MARGIN PREFIX \[dq]Page\[dq]"
-.nop ".PAGING MODE SECTION \[dq]\[dq] SUFFIX \[dq]\[dq]"
-.RE
-.RE
-.
-.
-.P
-If neither page number nor heading is used, the text will start on the
-first logical line.
-.
-Otherwise it will start on the fourth logical line.
-.
-If the page number is at the bottom, text will end on the fourth line
-from the bottom.
-.
-If the paging and headinq mode conflict, the page string overwrites
-the heading.
-.
-.RE
-.
-.
-.TP
-.FONT CB ".ODD PAGE"
-This
-.FONT CI "control word"
-causes the ourrent page to be printed out and the next page to be
-started with the next higher odd number.
-.
-.
-.TP
-.FONT CB .PAGE I " n"
-If
-.I n
-is present, insert a page break and start numbering the next pege
-with
-.IR n .
-Otherwise, turn the
-.I paging mode
-on and do not insert a page break.
-.
-.
-.TP
-.FONT CB .EJECT I " n"
-Insert a page break if either there are fewer than
-.I n
-lines left on the page or
-.I n
-is not present.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Lines and Spacing
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB ".SINGLE SPACE"
-Sing1e space all 1ines within paragraphs.
-.
-This is the initial state.
-.
-.
-.TP
-.FONT CB ".DOUBLE SPACE"
-Double space all lines within paragraphs.
-.
-.
-.TP
-.FONT CB .SPACE I " n"
-Output
-.I n
-1ine spaces.
-.
-If
-.I n
-is not provided, 1 is assumed.
-.
-In case of page overflow all remaining blank 1ines to be output are
-deleted.
-.
-.
-.TP
-.FONT CB ".FIGURE SPACING" I " n"
-This command is equivalent to
-.FONT CB .EJECT I " n"
-followed by
-.FONT CB .SPACE
-.IR n .
-.
-These commands provide the only means of creatinq blank 11nes.
-.
-.
-.TP
-.FONT CB .BREAK
-The lines before and after this command will not be run together in
-.IR "fill mode" .
-.
-A simpler way to get a line break is to insert one or more blank lines
-in the text.
-.
-.
-.TP
-.FONT CB ".BEGIN GROUP"
-.TQ
-.FONT CB ".END GROUP"
-The output lines enclosed between these two commands are forced to lie
-on a page.
-.
-Thus this command acts in a manner similar to
-.FONT CB .EJECT I " n" R ,
-where
-.I n
-has the 'right' value.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Miscellanous
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .UNDERLINE
-The following 1ine is underlined.
-.
-.
-.TP
-.FONT CB .LITERAL
-The next line is taken as part of text whether or not
-it begins with dot.
-.
-.
-.TP
-.FONT CB .ESCAPE I <char>
-.TQ
-.FONT CB .SHIFT I <char>
-.TQ
-.FONT CB ".TAB CHARACTER" I <char>
-The given character becomes the
-.IR escape ,
-.IR shift ,
-or
-.I tab
-character.
-.
-The parameter for the
-.FONT CB .SHIFT
-and
-.FONT CB ".TAB CHARACTER"
-commands may be null, if no
-.I shift
-or
-.I tab
-character is desired.
-.
-.
-.TP
-.FONT CB ".DEFINE COMMAND" I " <name>"
-.TQ
-.FONT CB ".END COMMAND"
-.TQ
-.FONT CB .CALL I " <name>"
-These commands give the user the opportunity to combine text and
-control lines to form his own commands.
-.
-All text and command lines between the first and second commands is
-stored away under
-.IR name .
-.
-When the third command is executed, the stored string is read and the
-commands within the string are executed.
-.
-Recursion is not permitted.
-.
-.
-.TP
-.FONT CB .INDEX I " <phrase>, <phrase>"
-.
-.FONT CB RUNOfF
-saves the first phrase in the main index table and the second phrase
-(if any) in a sub\-index table associated with the first phrase.
-.
-.RS
-.
-The index is formatted and output after the last page of text.
-.
-Two built\-in but redefinable formats,
-.FONT CI RINDEX
-and
-.FONT CI SINDEX R ,
-are used to format the index as shown in the following example.
-.
-.RS
-.nh
-.nf
-.FONT CB "Algorithms, 40, 78," R "             \[rs]\[dq] uses " I RINDEX
-.FONT CB "  analysis of, 27, " R "             \[rs]\[dq] uses " I SINDEX
-.fi
-.hy
-.RE
-.
-.
-The following lines give the initial definitions for the indexing
-formats.
-.
-.
-.RS
-.nh
-.nf
-.ft CB
-.nop ".define format RINDEX f(A)"
-.nop "AAAAAAAAAAAAAAAAAAAAAAAAAAA"
-.nop "    AAAAAAAAAAIAAAAAAAAAAAA"
-.nop ".end format"
-.nop ".define format SINDEX f(A)"
-.nop "  AAAAAAAAAAAAAAAAAAAAAAAAA"
-.nop "    AAAAAAAAAAIAAAAAAAAAAAA"
-.nop ".end format"
-.ft
-.fi
-.hy
-.RE
-.
-.
-In order to get an index output in two columns,
-.RS
-.P
-.FONT CB ".LINE LAYOUT 15, 75, 2, 4"
-.P
-should be the last line of the input.
-.RE
-.
-.RE
-.
-.
-.\" --------------------------------------------------------------------
-.SH RUNOFF DOCUMENTATION 1974
-.\" --------------------------------------------------------------------
-.
-This document is the best documentation about text lines.
-.
-Parts of that is used in the document of 1981.
-.
-The documentation of text lines is the best at all.
-.
-This is reguarded above.
-.
-.
-.P
-The documentation of commands will be including later on.
-.
-.
-.\" --------------------------------------------------------------------
-.SH RUNOFF COMMAND ADDITIONS 1981
-.\" --------------------------------------------------------------------
-.
-The following
-.I commands
-will be recognized if they are at the beginning of a line started with
-a period.
-.
-Any line in the source file beginning with a period is assumed to be
-one of these
-.IR commands .
-.
-If it is not, an
-.I error diagnostic
-will be typed and the line will be ignored.
-.
-Some
-.I commands
-take one or more decimal numeric arguments.
-.
-These are separated from the
-.I command
-by a
-.FONT CR space R .
-.
-More than one
-.I command
-may be entered on a single line by separating the
-.I commands
-with a
-.FONT CI semicolon
-.FONT R ` CB ; R '
-or a
-.FONT CI period
-.FONT R ` CB . R '.
-.
-.
-.P
-.I Multi\-word commands
-may appear in any form.
-.
-Thus,
-.FONT CB ".NO HEADER"
-and
-.FONT CB .NOHEADER
-are both legal.
-.
-.
-.P
-Many
-.I commands
-may be abbreviated.
-.
-Standard
-.I abbreviations
-are given below each
-.IR command .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Text Formatting Commands
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .BREAK
-.TQ
-.FONT CB .BR
-causes a
-.IR break ,
-i.e. the current line will be output with no
-.IR justification ,
-and the next word of the source text will be placed at the beginning
-of the next line.
-.
-.
-.TP
-.FONT CB .SKIP CI " n"
-.TQ
-.FONT CB .SK CI " n"
-.TQ
-.FONT CB .S CI " n"
-causes a BREAK after which
-.CI n
-is multiplied by the number of
-.I spaces
-between lines.
-.
-The result is the number of lines
-.IR skipped .
-.
-Output is advanced to the top of the next page if there is no room on
-the current page.
-.
-If the current page is empty,
-.FONT CB .SKIP
-does nothing.
-.
-.
-.TP
-.FONT CB .BLANK I " n"
-.TQ
-.FONT CB .B I " n"
-causes the current line to be output with no
-.IR justification ,
-skips
-.FONT CI n
-line spaces, and then starts output of the current source text.
-.
-.FONT CB .BLANK
-is like
-.FONT CB .SKIP R ,
-except that the
-.I space
-to be left is independent of line spacing.
-.
-If the page is empty,
-.FONT CB .BLANK
-does nothing.
-.
-.
-.TP
-.FONT CB .FIGURE I " n"
-.TQ
-.FONT CB .FG I " n"
-leaves
-.I n
-lines blank to make room for a figure or diagram.
-.
-If fewer than
-.I n
-lines remain on the current page, text continues to
-.I fill
-this page, then the page is advanced and
-.I n
-blank lines are left at the top of the next page.
-.
-.
-.TP
-.FONT CB .INDENT I " n"
-.TQ
-.FONT CB .I I " n"
-causes a
-.CI break
-and sets the next line to begin
-.I n
-spaces to the right of the left margin.
-.
-The
-.I n
-can be negative to allow beginning a line to the left of the left
-margin.
-.
-However, a line cannot begin to the left of column 0.
-.
-If
-.I n
-is not supplied, the current paragraph indent is used.
-.
-.
-.TP
-.FONT CB .PARAGRAPH I " n, v, t"
-.FONT CB .P I " n, v, t"
-causes a
-.I break
-and formats the output paragraphs.
-.
-The
-.I n
-is optional and, if present, sets the number of spaces the paragraph
-is to be indented.
-.
-The default value for
-.I n
-is
-.FONT CB 5
-.RI ( n
-can also have a negative value).
-.
-.I v
-is the vertical spacing between paragraphs.
-.
-.I v
-can range from
-.FONT CB 0
-to
-.FONT CB 5 R .
-.
-.FONT R ( CB 1
-is
-.IR "single spacing" ,
-.FONT CB 2
-is
-.IR "double spacing" ,
-etc.)
-.
-.I t
-causes an automatic
-.FONT CI ".TEST PAGE"
-(see the
-.FONT CB ".TEST PAGE"
-.IR command ).
-.
-.
-.TP
-.FONT CB .CENTER I " n" CB ; I text
-.TQ
-.FONT CB .CENTRE I " n" CB ; I text
-.TQ
-.FONT CB .C I " n" CB ; I text
-causes a
-.I break
-and centers the following text in the source file.
-.
-The centering is over column
-.FONT CB ( I n CB " + " I "left margin" CB )/2 R .
-If
-.I n
-is not given, it is assumed to be the
-.
-.IR "right margin" .
-.
-.
-.RS
-.P
-.ce
-NOTE
-.
-.P
-.FONT CB .CENTER R ,
-.FONT CB ".RIGHT MARGIN" R ,
-.FONT CB ".LEFT MARGIN" R ,
-.FONT CB ".PAGE SIZE" R ,
-and
-.FONT CB .STANDARD
-take both relative and absolute values.
-.
-Relative values are expressed as
-.FONT CB + I n
-or
-.FONT CB \- I n R ,
-while absolute values of
-.I n
-are unsigned.
-.RE
-.
-.
-.TP
-.FONT CB .FOOTNOTE I " n"
-.TQ
-.FONT CB .FN I " n"
-saves
-.I n
-lines at the bottom of the current page for a
-.IR footnote .
-.
-The
-.I n
-is multiplied by the number of spaces set with the
-.FONT CB .SPACING
-command.
-.
-If insufficient room remains on the current page, space is allocated
-at the bottom of the following page.
-.
-The text of the
-.I footnote
-should begin on the line following the
-.FONT CB .FOOTNOTE
-command.
-.
-.IR Indentation ,
-.IR "case lock" ,
-.IR justify ,
-.IR margins ,
-.IR spacing ,
-and
-.I fill
-are preserved around footnotes.
-.
-However,
-.I commands
-that affect page formatting are illegal in a
-.IR footnote .
-.
-.I Tab stops
-are illegal because they are not preserved.
-.
-A footnote within a footnote is also illegal.
-.
-.
-.P
-The actual space taken by a footnote can be more or less than
-specified by
-.IR n .
-If necessary
-.FONT CR adjust
-.I n
-after examining a draft printout.
-.
-.
-.P
-The
-.I footnote
-is terminated with a line beginning with an exclamation point (the
-remainder of which is ignored).
-.
-.
-.TP
-.FONT CB .NOTE I " text"
-.TQ
-.FONT CB .NT I " text"
-starts an
-.IR "indented note" .
-.
-This command
-.I blanks
-.FONT CB 2 R ,
-reduces both
-.IR margins ,
-.I centers
-the text (if no text is given, it centers the word
-.FONT CB NOTE R ),
-and then
-.I blanks
-.FONT CB 1 R .
-.
-At this point you enter the text of the
-.IR note .
-.
-If the left margin is at
-.FONT CB 0 R ,
-the
-.I margin reduction
-is
-.FONT CB 15 R ,
-otherwise it is
-.FONT CB 5 R .
-.
-.
-.TP
-.FONT CB ".END NOTE"
-.TQ
-.FONT CB .EN
-terminates the
-.FONT CB .NOTE
-command,
-.I blanks
-.CONT CB 2 R ,
-and reverts the margins and spacing modes to their settings before the
-last
-.FONT CB .NOTE
-command.
-.
-.
-.TP
-.FONT CB .LIST I " n"
-.FONT CB .LS I " n"
-starts an indented list with
-.I n
-spacing, moves the left margin
-.FONT CB 9
-spaces to the right for the first
-.FONT CB .LIST
-command, and
-.FONT CB 4
-more spaces for each subsequent nested
-.FONT CB .LIST R .
-.
-The normal
-.I fill
-and
-.I justify modes
-remain in effect.
-.
-Therefore, you must disengage them just after the
-.FONT CB .LS
-command if you want a ragged right.
-.
-.
-.TP
-.FONT CB ".LIST ELEMENT;" I " text"
-.TQ
-.FONT CB .LE; I " text"
-starts an item in the list, used in conjunction with the
-.FONT CB .LIST
-comand.
-.
-The elements are numbered sequentially and the number is given a
-negative indent so that the list lines up.
-.
-The number is followed by a
-.I period
-and two
-.I spaces
-so that the indent will be by 
-.FONT CB \-4 R .
-.
-The
-.I list elements
-are separated by the standard paragraph spacing and
-.FONT CI "TEST PAGE" R .
-.
-If you want to type the text on the same line as the command, you must
-separate the text from the command with any number of intervening
-.I spaces
-or
-.IR tabs ,
-or (optionally) one
-.IR semicolon .
-.
-.
-.TP
-.FONT CB ".END LIST"
-.TQ
-.FONT CB .ELS
-terminates the
-.FONT CB .LIST
-command and returns to settings before the last
-.FONT CB .LIST
-command.
-.
-.
-.TP
-.FONT CB .COMMENT I " text"
-.TQ
-.FONT CB .; I " text"
-causes the line to be ignored.
-.
-The text is not printed in the output file, but rather is used as a
-.I comment
-line in the source text.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Page Formatting Commands
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .PAGE
-.FONT CB .PG
-causes a
-.I break
-and an
-.I advance
-to a new page.
-.
-If the current page is empty, this
-.I command
-does not
-.I advance
-the page.
-.
-Just like an
-.IR "automatic page advance" ,
-this
-.I command
-prints the
-.I title
-(if given) and
-.I page numbers
-on every page.
-.
-.
-.TP
-.FONT CB ".TEST PAGE" I " n"
-.TQ
-.FONT CB .TP I " n"
-causes a
-.I break
-followed by a
-.IR "conditional page advance" .
-.
-It skips to the next page if fewer than
-.I n
-lines are left on the page.
-.
-This capability is to ensure that the following
-.I n
-lines are all output on the same page.
-.
-This
-.I command
-has the form
-.I t
-as an optional argument to the
-.FONT CB .PARAGRAPH
-command.
-.
-.
-.TP
-.FONT CB .NUMBER I " n"
-.TQ
-.FONT CB .NM I " n"
-starts page numbering.
-.
-This is the default so there is no reason to issue this command unless
-page numbering is disengaged.
-.
-If
-.I resumption
-of page numbering is desired at a certain page, specify
-.IR n .
-.
-.
-.TP
-.FONT CB .NONUMBER
-.FONT CB .NNM
-disengages page numbering.
-.
-However, pages continue to be counted, so that the normal page number
-can appear if page numbering is re\-entered with the
-.FONT CB .NUMBER
-command.
-.
-.
-.TP
-.FONT CB .CHAPTER I " text"
-.TQ
-.FONT CB .CH I " text"
-starts a new chapter using the text as the title of the chapter.
-.
-This
-.I command
-acts as if the following
-.I command string
-were entered:
-.
-.
-.P
-.EX
-.nop ".BREAK;.PAGE;.BLANK 12;.CENTER;CHAPTER n"
-.EE
-.P
-The
-.I n
-is incremented by
-.FONT CB 1
-automatically.
-.
-After the CHAPTER
-.I n
-is typed on the page,
-.
-.
-.P
-.EX
-.nop .BLANK 2;.CENTER;text;.BLANK 3
-.EE
-.P
-occurs.
-.
-This
-.I command
-then resets the
-.IR case ,
-.IR margins ,
-.IR spacing ,
-and
-.IR "justify/fill modes" .
-.
-It also clears any
-.I subtitles
-and sets the
-.I chapter name
-as the
-.IR title .
-.
-.
-.TP
-.FONT CB ".NUMBER CHAPTER " I " n"
-supplies a number
-.I n
-to be used in a subsequent
-.FONT CB .CHAPTER
-command.
-.
-.FONT CB ".NUMBER CHAPTER"
-would be used when a
-.I chapter
-of a document occupies a source file of its own.
-.
-In such a case,
-.FONT CB ".NUMBER CHAPTER"
-would be the first command of the source file.
-.
-.
-.TP
-.FONT  CB ".HEADER LEVEL" I " n text"
-.TQ
-.FONT CB .HL I " n text"
-starts a section at the level specified and takes the following text
-as the header.
-.
-.I n
-can range from
-.FONT CB 1
-to
-.FONT CB 5 R .
-.
-The sections are incremented by
-.FONT CB 1
-automatically, and the number is output in the form
-.FONT I i CB . I j CB . I k CB . I l CB . I m R .
-If this is a chapter oriented document, the
-.I i
-is the chapter number.
-.
-Otherwise, it is the number of the
-.FONT CB ".HL 1"
-level.
-.
-This command acts as a
-.
-.P
-.EX
-.FONT CB ".BREAK;.TEST PAGE 9;.BLANK 3"
-.EE
-.
-.P
-followed by the
-.IR "section number" ,
-two
-.IR spaces ,
-and the
-.IR "section name" .
-.
-.FONT CI "HEADER LEVELS " CB 1
-and
-.FONT CB 2
-end with a
-.IR break .
-.FONT CI "HEADER LEVELS"
-.FONT CB 3 R ", " CB 4 R ,
-and
-.FONT CB 5
-end with a space\-dash\-space combination (#\-#).
-.
-.
-.TP
-.FONT CB .TITLE I " text"
-.TQ
-.FONT CB .T I " text"
-takes the remaining text as the title and outputs it on every page at
-line
-.FONT CB 0 R .
-.
-The default is no title.
-.
-If a
-.I title
-is desired, this
-.I command
-must be entered in the source file.
-.
-.
-.TP
-.FONT CB ".FIRST TITLE" I " text"
-.TQ
-.FONT CB ".FT" I " text"
-Same as
-.FONT CB .TITLE R ,
-but used to specify the title to be printed on the first page of the
-document.
-.
-This command must precede all text in the source file.
-.
-Use of the
-.FONT CB ".FIRST TITLE"
-command is the only way to print a title line on the first page of the
-document.
-.
-.
-.TP
-.FONT CB .SUBTITLE I " text"
-.TQ
-.FONT CB .SUBTTL I " text"
-.TQ
-.FONT CB .ST I " text"
-takes the remaining text as the
-.I subtitle
-and outputs it on every page.
-.
-It appears directly under the title.
-.
-The
-.I subtitle
-is not
-.IR indented ,
-but
-.I indentation
-can be achieved by typing leading spaces.
-.
-.
-.TP
-.FONT CB .INDEX I " text"
-.TQ
-.FONT CB .X I " text"
-takes the remaining text on the line as a keyword and adds it, along
-with the current
-.IR "page number" ,
-to the internal index buffer.
-.
-The command does not cause a
-.IR break .
-.
-It should appear immediately before the item to be
-.IR indexed .
-.
-A keyword may be
-.I indexed
-more than once.
-.
-.
-.TP
-.FONT CB ".DO INDEX" I " text"
-.TQ
-.FONT CB ".DX" I " text"
-forces a new page, centers the text, if given, otherwise it centers
-the word
-.FONT CI "INDEX" R .
-.
-This command prints the entire contents of the index buffer.
-.
-Entries are printed in alphabetic order and are set against the left
-margin.
-.
-Regular line spacing is used, except that a blank line is left between
-entries of different first letters.
-.
-The page number of each entry is placed on the same line as the entry
-and in the middle of the page.
-.
-Additional page numbers for multiple entries follow, separated by
-commas.
-.
-The index buffer is left empty.
-.
-.
-.TP
-.FONT CB ".PRINT INDEX"
-.TQ
-.FONT CB ".PX"
-forces a new page after which it prints the entire contents of the
-index buffer.
-.
-Entries are printed in alphabetical order and are set against the left
-margin.
-.
-Regular line spacing is used, except that a blank line is left between
-entries of different first letters.
-.
-The number of the first page on which each entry appeared is put on
-the same line as the entry, beginning at the middle of the line
-(midway betweeen the left and right margins).
-.
-Additional page numbers for multiple entries follow, separated by
-commas.
-.
-The index buffer is left empty.
-.
-.
-.P
-.FONT CB ".PRINT INDEX"
-and
-.FONT CB ".DO INDEX"
-perform the same task.
-.
-The only difference is that
-.FONT CB ".PRINT INDEX"
-does not interrupt the normal chapter and page sequencing.
-.
-.
-.TP
-.FONT CB .SUBPAGE
-executes a
-.FONT CB .PAGE
-with page numbering suspended.
-.
-The page number is unchanged, but letters are appended to the page
-number.
-.
-This permits insertion of additional pages within an existing document
-without changing the existing page numbering.
-.
-.
-.TP
-.FONT CB ".END SUBPAGE"
-disengages the
-.FONT CB .SUBPAGE
-command by executing a
-.FONT CB .PAGE
-command with page numbering resumed.
-.
-.
-.TP
-.FONT CB .APPENDIX I " text"
-.TP
-.FONT CB .AX I " text"
-starts a new appendix using the text as the title of the appendix.
-.
-This command acts as if the following command string were entered:
-.
-.RS
-.P
-.EX
-.nop ".BREAK;.PAGE;.BLANK 12;.CENTER;APPENDIX a"
-.EE
-.RE
-.P
-The a is a letter that is incremented alphabetically automatically.
-.
-After the
-.FONT CB "APPENDIX A"
-is typed on the page,
-.
-.RS
-.P
-.EX
-.nop .BLANK 2;.CENTER;text;.BLANK 3
-.EE
-.RE
-.
-.P
-occurs.
-.
-This command then resets the
-.IR case ,
-.IR margins ,
-.IR spacing ,
-and
-.IR justify/fill
-modes.
-.
-It also clears any subtitles and sets the appendix name as the title.
-.
-.
-.TP
-.FONT CB ".NUMBER APPENDIX" I " a"
-supplies a letter
-.I a
-to be used as the letter for a subsequent
-.FONT CB .APPENDIX
-command.
-.
-.
-.TP
-.FONT CB .HEADER I " arg"
-.TQ
-.FONT CB .HD I " arg"
-causes the page header
-.RI ( title ,
-.IR subtitle ,
-and
-.IR "page number" )
-to be printed.
-.
-.I arg should be
-.FONT CB UPPER
-to specify
-.I upper case characters
-for the title text,
-.FONT CB LOWER
-to specify
-.IR "lower case" ,
-or
-.FONT CB MIXED R .
-.
-The initial setting is
-.FONT CB ".HEADER UPPER" R .
-.
-.
-.TP
-.FONT CB .NOHEADER
-.TP
-.FONT CB .NHD
-causes the page header
-.RI ( title ,
-.IR subtitle ,
-and
-.IR "page number" )
-to be omitted.
-.
-The header lines are completely omitted, so that text begins at the
-top of the page with no
-.IR "top margin" .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Mode Setting Commands
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .JUSTIFY
-.TQ
-.FONT CB .J
-causes a break and sets subsequent output lines to be justified
-(initial setting).
-.
-The
-.I command
-increases the spaces between words until the last word exactly meets
-the right margin.
-.
-.
-.TP
-.FONT CB .NOJUSTIFY
-.TQ
-.FONT CB .NJ
-causes a
-.I break
-and prevents
-.I justification
-of subsequent output lines to make a ragged right margin.
-.
-.
-.TP
-.FONT CB .FILL
-.TQ
-.FONT CB .F
-causes a break and specifies that subsequent output lines be filled
-(inital setting).
-.
-Sets the justification mode to be that specified by the last
-appearance of
-.FONT CB  .JUSTIFY
-or
-.FONT CB .NOJUSTIFY R .
-.
-.FONT CB .FILL
-adds successive words from the source text until the adding of one
-more word will exceed the right margin.
-.
-It stops before putting the last word in.
-.
-(If
-.I hyphenation
-has not been disabled,
-.FONT CB RNO
-will attempt to
-.I break
-words which cause line overflow into syllables.)
-.
-.
-.TP
-.FONT CB .NOFILL
-.TP
-.FONT CB .NF
-disengages the
-.I fill
-and
-.IR "justify modes" .
-.
-This
-.I command
-is used to permit typing a table.
-.
-.
-.RS
-.
-.
-.P
-.ce
-NOTE
-.
-.P
-1. The
-.I nofill\-nojustify mode
-need be used only where there are several lines of material to be
-copied exactly.
-.
-A single line example will not require using these commands if there
-are breaks before and after.
-.
-.
-.P
-2. Normally
-.FONT CB .FILL
-and
-.FONT CB .NOFILL
-are used to turn both
-.I filling
-and
-.I justification
-on and off.
-.
-It is usually desirable to do both.
-.
-A subsequent appearance of a
-.I justification command
-will override the
-.I fill command
-however.
-.
-.
-.P
-3. Because of the action of
-.FONT CB .FILL R ,
-a single occurrance of
-.FONT CB .NOJUSTIFY
-will cause the remainder of the file to be
-.IR unjustified ,
-with
-.I filling
-as specified.
-.
-In order to
-.I justify
-but
-.I not fill
-(not recommended), a
-.FONT CB .JUSTIFY
-command must follow every
-.FONT CB .NOFILL
-command.
-.
-.
-.RE
-.
-.
-.TP
-.FONT CB ".UPPER CASE"
-.TQ
-.FONT CB .UC
-sets the output mode to
-.IR "upper case" .
-.
-This comand acts the same as typing two
-.CI circumflexes
-.FONT CB ^^ R .
-.
-This is the default mode.
-.
-There is no need to type this command unless the mode was previously
-altered to
-.IR "lower case" .
-.
-.
-.TP
-.FONT CB ".LOWER CASE"
-.TQ
-.FONT CB .LC
-sets the typeout mode to
-.IR "lower case" .
-This command acts the same as typing two
-.I back\-slashes
-.FONT CB \[rs]\[rs] R .
-.
-.
-.TP
-.FONT CB ".FLAGS CAPITALIZE"
-.TQ
-.FONT CB ".FL CAPITALIZE"
-enables the
-.CI less\-than
-.FONT CB <
-character to
-.I capitalize
-the entire word it precedes.
-.
-It then returns the file to the current case mode.
-.
-This
-.I special character
-is usually
-.FONT CR off
-and must be typed at the very beginning of the source text to enable
-this character.
-.
-Typing a space or another
-.FONT CI "less\-than " CB <
-returns the file to the current
-.IR "case lock" .
-.
-.
-.TP
-.FONT CB ".NO FLAGS CAPITALIZE"
-.TQ
-.FONT CB .NFC
-disengages the
-.FONT CB "FLAG CAPITALIZE"
-command (inital setting).
-.
-.
-.TP
-.FONT CB .HYPHENATION
-.TQ
-.FONT CB .HY
-engages
-.I hyphenization
-(initial setting).
-.
-.
-.TP
-.FONT CB ".NO HYPHENATION"
-.TQ
-.FONT CB .NHY
-disengages
-IR hyphenization .
-.
-.
-.TP
-.FONT CB ".FLAGS HYPHENATE"
-.TQ
-.FONT CB ".FL HYPHENATE"
-enables the
-.I equals character
-.FONT CB =
-to disengage
-.I hyphenization
-for the word it precedes.
-.
-This
-.I special character
-is initially
-.FONT CR off
-and must be typed at the beginning of the source file to enable this
-character.
-.
-The
-.FONT CI "FLAGS HYPHENATE"
-.I character
-is used to disengage
-.I hyphenization
-for words improperly
-.I hyphenated
-by the
-.IR "hyphenization algorithm" .
-.
-.
-.TP
-.FONT CB ".NO FLAGS HYPHENATE"
-.TQ
-.FONT CB .NFH
-disengages the
-.FONT CB ".FLAGS HYPHENATE"
-command (initial setting).
-.
-.
-.TP
-.FONT CB .NFL
-disengages the
-.FONT CB ".FLAGS CAPITALIZE"
-and the
-.FONT CB ".FLAGS HYPHENATE"
-commands (initial setting).
-.
-.
-.TP
-.FONT CB .PERIOD
-.TQ
-.FONT CB .PR
-enables printing of two
-.I spaces
-after every
-.I period
-.FONT CB .
-that is followed by at least one
-.I separator character
-(initial setting).
-.
-.
-.TP
-.FONT CB .NOPERIOD
-.TQ
-.FONT CB .NPR
-disengages conversion of
-.I period/separator
-to
-.IR "period/two spaces" .
-.
-.
-.TP
-.FONT CB .LITERAL
-.TQ
-,FONT CB .LIT
-disengages
-.I fill/justify
-to permit printing of text exactly as entered in source file.
-.
-.
-.TP
-.FONT CB ".END LITERAL"
-.TQ
-.FONT CB .ELI
-used after
-.FONT CB .LITERAL
-command to re\-engage
-.IR fill/justify .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Parameter Setting Commands
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB ".LEFT MARGIN" I " n"
-.TQ
-.FONT CB .LM I " n"
-sets the left margin to
-.IR n .
-.
-The
-.I n
-must be less than the right margin but not less than
-.FONT CB 0 R .
-The initial setting is
-.FONT CB 0 R .
-If
-.I n
-is not supplied,
-.FONT CB 0
-is used.
-.
-.
-.TP
-.FONT CB ".RIGHT MARGIN" I " n"
-.TQ
-.FONT CB .RM I " n"
-sets the right margin
-.IR n .
-The
-.I n
-must be greater than the left margin.
-.
-The initial setting is
-.FONT CB 60 R .
-.
-If
-.I n
-is not supplied, the current page width (set with the
-.FONT CB ".PAGE SIZE"
-command) is used.
-.
-.
-.TP
-.FONT CB ".PAPER SIZE" I " n" CB , I m
-.TP
-.FONT CB ".PAGE SIZE" I " n" CB , I m
-.TP
-.FONT CB ".PS" I " n" CB , I m
-sets the size of the page
-.I n
-lines by
-.I m
-columns and sets the right margin to
-.IR m .
-The default setting is
-.FONT CB 58,60 R .
-.
-.
-.TP
-.FONT CB .PITCH I " n" CB , I m
-.TQ
-.FONT CB .PIT I " n" CB , I m
-sets the horizontal and vertical pitch on a supporting output device.
-.
-The horizontal pitch is
-.I n
-and is specified as characters per inch.
-.
-The value must divide evenly into
-.FONT CB 60
-for
-.FONT CI "Anderson\-Jacobson devices"
-and into
-.FONT CB 120
-for
-.FONT CI "Diablo devices" R .
-.
-The default is
-.FONT CB 12 R .
-.
-.
-.P
-The vertical pitch is
-.I m
-and is specified as lines per inch.
-.
-.I m
-must divide evenly into
-.FONT CB 48 R .
-.
-The default is the hardware setting.
-.
-.I n
-and
-.I m
-may be set independently.
-.
-.
-.TP
-.FONT CB .SPACING I " n"
-.TQ
-.FONT CB .SP I " n"
-sets the number of spaces between lines.
-.
-The
-.I n
-can range from
-.FONT CB 1
-to
-.FONT CB 5 R .
-.
-The default setting is
-.FONT CB 1 R .
-.
-.FONT CB ".SPACING 1"
-is like
-.I single spacing
-on a typewriter and
-.FONT CB ".SPACING 2"
-is like
-.IR "double spacing" .
-.FONT CB ".SPACING 2"
-puts one
-.I blank line
-between lines of text.
-.
-.
-.TP
-.FONT CB .STANDARD I " n"
-.TQ
-.FONT CB .SD I " n"
-returns all parameters, except the pitch settings, to their initial
-settings and sets
-.I n
-as the page width.
-.
-If
-.FONT CB ".STANDARD 60"
-is specified, margins are reset
-.FONT CB ".LM 0" R ,
-.FONT CB ".RM 60" R ,
-.FONT CB ".PAGE SIZE 58,60" R ,
-.FONT CB ".SPACING 1" R ,
-.FONT CB "PARAGRAPH INDENT 5" R ,
-and
-.I fill
-and
-.I justify
-are enabled.
-.
-.FONT CB ".STANDARD 70"
-sets right margin to
-.FONT CB 70
-and
-.I page size
-to
-.FONT CB 58,70 R .
-.
-.
-.TP
-.FONT CB ".TAB STOPS" I " n" CB , I n CB , I \*[Ellipsis]
-.TQ
-.FONT CB ".TS" I " n" CB , I n CB , I \*[Ellipsis]
-sets tabs.
-.
-The
-.I  n
-must be greater than
-.FONT CB 0
-and listed in ascending order.
-.
-If tabs already exist, the issuing of another
-.FONT CB ".TAB STOPS"
-command clears all previous
-.I tabs
-before setting new ones.
-.
-The
-.I default tabs
-are set at eight\-column intervals to match the
-.FONT CR Digital
-hardware standard.
-.
-These
-.I tabs
-are at columns
-.FONT CB 8 R ,
-.FONT CB 16 R ,
-.FONT CB 24 R ,
-.FONT CB 32 R ,
-.FONT CB 40 R ,
-.FONT CB 48 R ,
-.FONT CB 56 R ,
-.FONT CB 64 R ,
-.FONT CB 72 R ,
-and
-.FONT CB 80 R .
-.
-The tabs are converted to the appropriate number of non\-expandable
-spaces.
-.
-If there are no regular spaces to the left of the
-.IR tabs ,
-they will print out at the appropriate position, even if
-.I fill
-is on.
-.
-If
-.I literal
-is on, the
-.I tabs
-are not converted to
-.IR spaces ,
-but are output as
-.IR tabs .
-.
-.
-.TP
-.FONT CB .AUTOPARAGRAPH
-.TQ
-.FONT CB .AP
-causes any
-.I blank line
-or any line starting with a
-.I space
-or
-.I tab
-to be considered as the start of a new paragraph.
-.
-This command allows normally typed text to be
-.I justified
-without special commands.
-.
-It does not cause a paragraph if
-.I blank lines
-are followed by a command.
-.
-.
-.TP
-.FONT CB .NOAUTOPARAGRAPH
-.TQ
-.FONT CB .NAP
-disengages the
-.FONT CI AUTOPARAGRAPH
-mode.
-.
-.
-.\" --------------------------------------------------------------------
-.SS List of Commands (Alphabetical)
-.\" --------------------------------------------------------------------
-.
-.if t \{
-.ig endTBL
-.\}
-.
-.\" --------------------------------------------------------------------
-.\" Table using tbl for running in tty
-.\" --------------------------------------------------------------------
-.
-.nf
-.nh
-.
-.TS
-center,allbox,tab(@);
-cIw(1.5i) sw(1.5i) cIw(1.5i).
-Command or Abbreviation@Related Commands
-=
-.
-.T&
-l l l.
-\f[CB].AP\f[R]@(=\f[CB].AUTOPARAGRAPH\f[R])@
-\f[CB].APPENDIX\f[I] text \f[R]@(=\f[CB].AX\f[R])@\f[CB].NUMBER APPENDIX\f[I] a
-\f[CB].AX\f[R]@(=\f[CB].APPENDIX\f[R])@
-\f[CB].AUTOPARAGRAPH \f[R]@(=\f[CB].AP\f[R])@T{
-\f[CB].NOAUTOPARAGRAPH
-.br
-\f[R](\f[CB].NAP\f[R])
-T}
-_
-\f[CB].B\f[R]@(=\f[CB].BLANK\f[R])@
-\f[CB].BLANK \f[I]n \f[R]@(=\f[CB].B\f[R])@T{
-7\f[CB].SKIP \f[I]n
-.br
-\f[R](\f[CB].S\f[R])
-T}
-\f[CB].BR\f[R]@(=\f[CB].BREAK\f[R])@
-\f[CB].BREAK@\f[R](=\f[CB].BR\f[R])
-_
-\f[CB].C\f[R]@(=\f[CB].CENTRE\f[R])@
-\f[CB].CENTER\f[R]@(=\f[CB].CENTRE\f[R])@
-\f[CB].CENTRE \f[I]n\f[CB];\f[I]text \f[R]@(=\f[CB].C\f[R])@
-\f[CB].CH\f[R]@(=\f[CB].CHAPTER\f[R])@
-\f[CB].CHAPTER \f[I]text \f[R]@(=\f[CB].CH\f[R])@\f[CB].NUMBER CHAPTER \f[I]n
-\f[CB].COMMENT \f[I]text\f[R]@@
-_
-\f[CB].DO INDEX \f[I]text \f[R]@(=\f[CB].DX\f[R])@T{
-.
-\f[CB].PRINT INDEX
-.br
-\f[R](\f[CB].PX\f[R])
-T}
-.
-\f[CB].DX\f[R]@(=\f[CB].DO INDEX\f[R])@
-_
-\f[CB].ELS\f[R]@(=\f[CB].END LIST\f[R])@
-\f[CB].EN\f[R]@(=\f[CB].END NOTE\f[R])@
-.
-\f[CB].END LIST\f[R]@(=\f[CB].ELS\f[R])@T{
-\f[CB].LIST \f[I]n
-.br
-\f[R](\f[CB].LS\f[R])
-T}
-.
-\f[CB].END LITERAL \f[R]@(=\f[CB].ELI\f[R])@T{
-\f[CB].LITERAL
-.br
-\f[R](\f[CB].LIT\f[R])
-T}
-.
-\f[CB].END NOTE\f[R]@(=\f[CB].EN\f[R])@T{
-\f[CB].NOTE \f[I]text
-.br
-\f[R](\f[CB].NT\f[R])
-T}
-.
-\f[CB].END SUBPAGE\f[R]@@\f[CB].SUBPAGE
-_
-\f[CB].F\f[R]@(=\f[CB].FILL\f[R])@
-\f[CB].FG\f[R]@(=\f[CB].FIGURE\f[R])@
-\f[CB].FIGURE n \f[R]@(=\f[CB].FG\f[R])@
-.
-\f[CB].FILL \f[R]@(=\f[CB].F\f[R])@T{
-\f[CB].NOFILL
-.br
-\f[R](\f[CB].NF\f[R])
-T}
-.
-\f[CB].FIRST TITLE \f[I]text\f[R]@(=\f[CB].FT\f[R])@\f[CB].TITLE \f[I]text
-.
-\f[CB].FLAGS CAPITALIZE\f[R]@(=\f[CB].FL CAPITALIZE\f[R])@T{
-\f[CB].NO FLAGS CAPITALIZE
-.br
-\f[R](\f[CB].NFL\f[R])
-T}
-.
-\f[CB].FLAGS HYPHENATE \f[R]@(=\f[CB].FL HYPHENATE\f[R])@T{
-\f[CB].NO FLAGS HYPHENATE
-.br
-\f[R](\f[CB].NFH\f[R])
-T}
-.
-\f[CB].FN\f[R]@(=\f[CB].FOOTNOTE\f[R])@
-\f[CB].FOOTNOTE \f[I]n\f[R]@(=\f[CB].FN\f[R])@
-\f[CB].FT\f[R]@(=\f[CB].FIRST TITLE\f[R])@
-_
-\f[CB].HD\f[R]@(=\f[CB].HEADER\f[R])@
-.
-T{
-\f[CB].HEADER \f[I]arg\f[R]
-.br
-\f[R]  [\f[I]arg\f[R]=\f[CB]UPPER\f[R], \f[CB]LOWER\f[R], or \f[CB]MIXED]\f[R]
-T}@(=\f[CB].HD\f[R])@T{
-\f[CB].NOHEADER
-.br
-\f[R](\f[CB].NHD\f[R])
-T}
-.
-\f[CB].HEADER LEVEL \f[I]n text\f[R]@(=\f[CB].HL\f[R])@
-\f[CB].HL\f[R]@(=\f[CB].HEADER LEVEL\f[R])@
-\f[CB].HY\f[R]@(=\f[CB].HYPHENATION\f[R])@
-.
-\f[CB].HYPHENATION \f[R]@(=\f[CB].HY\f[R])@T{
-\f[CB].NO HYPHENATION
-.br
-\f[R](\f[CB].NHY\f[R])
-T}
-.
-_
-\f[CB].I\f[R]@(=\f[CB].INDENT\f[R])@
-\f[CB].INDENT \f[I]n\f[R]@(=\f[CB].I\f[R])@
-\f[CB].INDEX \f[I]text \f[R]@(=\f[CB].X\f[R])@
-_
-\f[CB].J\f[R]@(=\f[CB].JUSTIFY\f[R])@
-.
-\f[CB].JUSTIFY \f[R](\f[CB].J\f[R])@@T{
-\f[CB].NOJUSTIFY
-.br
-\f[R](\f[CB].NJ\f[R])
-T}
-.
-_
-\f[CB].LC\f[R]@(=\f[CB].LOWER CASE\f[R])@
-\f[CB].LE\f[R]@(=\f[CB].LIST ELEMENT\f[R])@
-.
-\f[CB].LEFT MARGIN \f[I]n\f[R]@(=\f[CB].LM\f[R])@T{
-\f[CB].RIGHT MARGIN \f[I]n
-.br
-\f[R](\f[CB].RM\f[R])
-T}
-.
-\f[CB].LIST \f[I]n\f[R]@(=\f[CB].LS\f[R])@T{
-\f[CB].END LIST
-.br
-\f[R](\f[CB].ELS\f[R])
-T}
-.
-\f[CB].LIST ELEMENT;\f[I]text\f[R]@(=\f[CB].LE\f[R])@T{
-\f[CB].END LIST
-.br
-\f[R](\f[CB].ELS\f[R])
-T}
-.
-\f[CB].LIT\f[R]@(=\f[CB].LITERAL\f[R])@
-.
-\f[CB].LITERAL\f[R]@(=\f[CB].LIT\f[R])@T{
-\f[CB].END LITERAL
-.br
-\f[R](\f[CB].ELI\f[R])
-T}
-.
-\f[CB].LM\f[R]@(=\f[CB].LEFT MARGIN\f[R])@
-.
-\f[CB].LOWER CASE\f[R]@(=\f[CB].LC\f[R])@T{
-\f[CB].UPPER CASE
-.br
-\f[R](\f[CB].UC\f[R])
-T}
-.
-\f[CB].LS\f[R]@(=\f[CB].LIST\f[R])@
-_
-\f[CB].NAP\f[R]@(=\f[CB].NOAUTOPARAGRAPH\f[R])@
-\f[CB].NF\f[R]@(=\f[CB].NOFILL\f[R])@
-\f[CB].NFC\f[R]@(=\f[CB].NO FLAGS CAPITALIZE\f[R])@
-\f[CB].NFH\f[R]@(=\f[CB].NO FLAGS HYPHENATE\f[R])@
-.
-\f[CB].NFL\f[R]@T{
-(=\f[CB].NO FLAGS CAPITALIZE
-.br
-.ce
-\f[R] and
-.br
-\f[CB].NO FLAGS HYPHENATE\f[R])
-T}@
-.
-\f[CB].NHD\f[R]@(=\f[CB].NO HEADER\f[R])@
-\f[CB].NHY\f[R]@(=\f[CB].NO HYPHENATION\f[R])@
-\f[CB].NJ\f[R]@(=\f[CB].NO JUSTIFY\f[R])@
-\f[CB].NM\f[R]@(=\f[CB].NUMBER\f[R])@
-\f[CB].NNM\f[R]@(=\f[CB].NO NUMBER\f[R])@
-.
-\f[CB].NOAUTOPARAGRAPH\f[R]@(=\f[CB].NAP\f[R])@T{
-\f[CB].AUTOPARAGRAPH \f[R](\f[CB].AP\f[R])
-.br
-\f[CB]\ .PARAGRAPH \f[I]n,v,t \f[R](\f[CB].P\f[R])
-T}
-.
-\f[CB].NOFILL\f[R]@=(\f[CB].NF\f[R])@T{
-\f[CB].FILL
-.br
-\f[R](\f[CB].F\f[R])
-T}
-.
-\f[CB].NO FLAGS CAPITALIZE\f[R]@(=\f[CB].NFL\f[R])@T{
-\f[CB].FLAGS CAPITALIZE
-.br
-\f[R](\f[CB].FL CAPITALIZE\f[R])
-T}
-.
-\f[CB].NO FLAGS HYPHENATE\f[R]@(=\f[CB].NFH\f[R])@T{
-\f[CB].FLAGS HYPHENATE
-.br
-\f[R](\f[CB].FL HYPHENATE\f[R])
-T}
-.
-\f[CB].NOHEADER\f[R]@(=\f[CB].NHD\f[R])@T{
-\f[CB].HEADER \f[I]arg
-.br
-\f[R](\f[CB].HD\f[R])
-T}
-.
-\f[CB].NO HYPHENATION \f[R]@(=\f[CB].NHY\f[R])@T{
-\f[CB].HYPHENATION
-.br
-\f[R](\f[CB].HY\f[R])
-T}
-.
-\f[CB].NOJUSTIFY \f[R]@(=\f[CB].NJ\f[R])@T{
-\f[CB].JUSTIFY
-.br
-\f[R](\f[CB].J\f[R])
-T}
-.
-\f[CB].NONUMBER \f[R]@(=\f[CB].NNM\f[R])@T{
-\f[CB].NUMBER \f[I]n
-.br
-\f[R](\f[CB].NM\f[R])
-T}
-.
-\f[CB].NOPERIOD \f[R]@(=\f[CB].NPR\f[R])@T{
-\f[CB].PERIOD
-.br
-\f[R](\f[CB].PR\f[R])
-T}
-.
-\f[CB].NOTE text \f[R]@(=\f[CB].NT\f[R])@T{
-\f[CB].END NOTE
-.br
-\f[R](\f[CB].EN\f[R])
-T}
-.
-\f[CB].NPR\f[R]@(=\f[CB].NO PERIOD\f[R])@
-\f[CB].NT\f[R]@(=\f[CB].NOTE\f[R])@
-\f[CB].NUMBER APPENDIX \f[I]a\f[R]@@\f[CB].APPENDIX text
-\f[CB].NUMBER CHAPTER \f[I]n\f[R]@@\f[CB].CHAPTER text
-_
-\f[CB].P\f[R]@(=\f[CB].PARAGRAPH\f[R])@
-\f[CB].PAGE\f[R]@(=\f[CB].PG\f[R])@
-\f[CB].PAGE SIZE\f[R]@(=\f[CB].PAPER SIZE\f[R])@
-.
-\f[CB].PAPER SIZE \f[I]v\f[CB],\f[I]h\f[R]@T{
-(=\f[CB].PS\f[R]
-.br
-\f[CB].PAGE SIZE\f[R])
-T}@
-.
-\f[CB].PARAGRAPH \f[I]h\f[CB],\f[I]v\f[CB],\f[I]t \f[R]@(=\f[CB].P\f[R])@
-\f[CB].SKIP \f[I]n\f[R]@(=\f[CB].S\f[R])@\f[CB].BLANK \f[I]n \f[R](\f[CB].B\f[R])
-\f[CB].SP\f[R]@(=\f[CB].SPACING\f[R])@
-\f[CB].SPACING \f[I]n \f[R]@(=\f[CB].SP\f[R])@
-.
-\f[CB].PERIOD\f[R]@(=\f[CB].PR\f[R])@T{
-\f[CB].NOPERIOD
-.br
-\f[R](\f[CB].NPR\f[R])
-T}
-.
-\f[CB].PG\f[R]@(=\f[CB].PAGE\f[R])@
-\f[CB].PITCH\f[R]@(=\f[CB].PIT\f[R])@
-
-.\f[CB].PRINT INDEX \f[R]@(=\f[CB].PX\f[R])@T{
-\f[CB].DO INDEX text
-.br
-\f[R](\f[CB].DX\f[R])
-T}
-.
-\f[CB].PS\f[R]@(=\f[CB].PAPER SIZE\f[R])@
-\f[CB].PX\f[R]@(=\f[CB].PRINT INDEX\f[R])@
-_
-\f[CB].RIGHT MARGIN \f[I]n \f[R]@(=\f[CB].RM\f[R])@
-\f[CB].RM\f[R]@(=\f[CB].RIGHT MARGIN\f[R])@
-_
-\f[CB].S\f[R]@(=\f[CB].SKIP\f[R])@
-\f[CB].SD\f[R]@(=\f[CB].STANDARD\f[R])@
-\f[CB].ST\f[R]@(=\f[CB].SUBTITLE\f[R])@
-\f[CB].SUBPAGE\f[R]@@\f[CB].END SUBPAGE
-\f[CB].SUBTITLE \f[I]text \f[R]@(=\f[CB].ST\f[R])@
-_
-\f[CB].T\f[R]@(=\f[CB].TITLE\f[R])@
-\f[CB].TAB STOPS \f[I]n,n, \*[Ellipsis] ,n \f[R]@(=\f[CB].TS\f[R])@
-\f[CB].TEST PAGE \f[I]n \f[R]@(=\f[CB].TP\f[R])@
-\f[CB].TITLE text\f[R]@(=\f[CB].T\f[R])@
-\f[CB].TP\f[R]@(=\f[CB].TEST PAGE\f[R])@
-\f[CB].TS\f[R]@(=\f[CB].TAB STOPS\f[R])@
-_
-\f[CB].UC\f[R]@(=\f[CB].UPPER CASE\f[R])@
-.
-\f[CB].UPPER CASE\f[R]@(=\f[CB].UC\f[R])@T{
-\f[CB].LOWER CASE
-.br
-\f[R](\f[CB].LC\f[R])
-T}
-.
-_
-\f[CB].X\f[R]@(=\f[CB].INDEX\f[R])@
-.
-.TE
-.
-.hy
-.fi
-.
-.
-.\" End of tbl ----------------------------------------------------------------
-.
-.
-.if t \{
-.  endTBL
-.\}
-.
-.
-.\" use groff_hdtbl
-.if t \{
-.  mso hdtbl.tmac
-.  TableHDTBL
-.\}
-.
-.
-.\" --------------------------------------------------------------------
-.SH EXPERIMENTAL ADDITIONS 1965
-.\" --------------------------------------------------------------------
-.
-.
-These
-.I "control words"
-are documented in
-.FONT CI Saltzer R 's
-documentation of 1965.
-.
-It is unsure whether they were really implemented.
-.
-.
-.P
-In this documentation, all
-.I control words
-are written in
-.IR "lower case" .
-.
-The writing in
-.I upper case
-is not mentioned, the same is true for
-.IR abbreviations .
-.
-So this documentation uses only
-.IR "lower case" . 
-.
-.
-.TP
-.FONT CB .FIGURE
-This
-.I control word
-turns control over to a 
-.I figure
-.IR processor ,
-which creates in
-.I core memory
-a representation of a
-.I flow diagram
-under the control of a few special
-.IR "control words" .
-When the
-.I control word
-.FONT CB ".END FIGURE"
-is encountered, the completed picture is printed immediately on the
-page being generated if there is room on that page; otherwise the
-.I figure
-will appear at the top of the next page.
-.
-.
-.RS
-.
-.
-.P
-Text following the
-.FONT CB ".END FIGURE"
-.I control word
-will be smoothly attached to text before the
-.FONT CB .FIGURE R .
-.
-No break is generated.
-.
-(Restriction: If a
-.I figure
-is being held for placement at the top of the next page, another
-.I figure
-may not be encountered before the first one is printed.)
-.
-.
-.P
-The only
-.I control words
-which are recognized when in the
-.I \%figure processor
-are the following three:
-.FONT CB .FRAME R ,
-.FONT CB .BOX R ,
-and
-.FONT CB ".END FIGURE" R .
-.
-.
-.RE
-.
-.
-.TP
-.FONT CB .FRAME I " m n"
-This
-.I control word
-intitalizes the
-.I figure  processor
-by giving the height and width of the figure to be produced.
-.
-.I m
-is
-the height, in lines; and
-.I n
-is the width, in characters.
-.
-(Note that a 1050 types 6 lines per inch, and 10 characters per inch.)
-.
-.
-.RS
-.
-.
-.P
-Any attempt to place items in the picture which extend beyond the
-boundaries will cause an error comment to be generated.
-.
-.I \%m
-and
-.I \%n
-must both be less than 100 and their product must be smaller than
-5400.
-.
-We may now think of the
-.I figure
-to be produced as an array of
-.I m
-times
-.I n
-elements.
-.
-.
-.RE
-.
-.
-.TP
-.FONT CB .BOX I " i j"
-The text on the lines following this
-.I control word
-will be placed in the
-.I figure
-such that the first character on the first line following the
-.FONT CB .BOX
-will appear in row
-.IR i ,
-character position
--IR j .
-.
-The end of the text is indicated by a
-.FONT CB .BOX
-.I control word
-for another piece of text or the
-.FONT CB ".END FIGURE"
-.I control
-.IR word .
-.
-Temporarily, the text should not include underlined or overtyped
-characters.
-.
-.
-.TP
-.FONT CB ".END FIGURE"
-This
-.I control word
-causes control to return to the regular
-.I control processor
-of the
-.FONT CB .RUNOFF
-command, for the decision to print the picture.
-.
-Note that another
-.FONT CB .FIGURE
-.I control word
-may not appear until after this
-.I figure
-has been printed.
-.
-.
-.RS
-.P
-One further
-.I control word
-has been added which is intended to facilitate bringing out revised
-editions of a memorandum.
-.
-.
-.RE
-.
-.
-.TP
-.FONT CB .FLAG
-The next line to be printed after this
-.I control word
-is encountered will have an asterisk placed two spaces to the right of
-the right margin, as illustrated.
-.
-.
-.TP
-.FONT CB .DEFINE I " symbol"
-.
-This
-.I control word
-defines  the  value  of  the  symbol
-.I symbol
-to be the number of the page currently being printed.
-.
-The symbol may be used later with the
-.FONT CB .USE
-.I control word
-to cause printing of the page number in text.
-.
-The characters in the symbol must be mappable into the six\-bit
-character set, and all symbols must be six of fewer characters.
-.
-.
-.TP
-.FONT CB .USE I " symbol"
-The value of the symbol
-.I symbol
-is inserted into the text with a single blank preceding and no blank
-following.
-.
-If the symbol has not been previously defined, its value is
-.FONT CB 0 R .
-Text may continue following a blank typed after the symbol.
-.
-.
-.RS
-.
-.
-.P
-Here is an example of the use of these
-.I control
-.IR words .
-.
-.
-.RS
-.
-.
-.P
-In one area of text:
-.
-.
-.RS
-.
-.
-.P
-We now discuss the operation of the typewriter
-.FONT CB ".DEFINE REF1"
-coordinator module, which \*[Ellipsis]
-.
-.
-.RE
-.
-.
-.P
-In a later area of text:
-.
-.
-.RS
-.
-.
-.P
-As we saw in the discussion of the typewriter coordinator on page
-.FONT CB ".USE REF1" R ,
-the rest of \*[Ellipsis]
-.
-.
-.RE
-.
-.
-.P
-if the first area of text were on page 14, the later line would read:
-.
-.
-.RS
-.
-.
-.P
-As we saw in the discussion of the typewriter coordinator on page 14,
-the rest of \*[Ellipsis]
-.
-.
-.RE
-.RE
-.RE
--
-.
-.\" --------------------------------------------------------------------
-.SS Further Study of Experimental Additions
-.\" --------------------------------------------------------------------
-.
-A number of suggestions have been made for extending the
-.I control word
-language of
-.FONT CI RUNOFF R ,
-and its capabilities.
-.
-These are listed here, primarily to elicit comment and discussion,
-both on the language which describes these operations and the less
-important problem of their implementation.
--
-.
-.TP
-1.
-.
-Word division.
-.
-This is a whole are of study in itself.
-.
-.
-.TP
-2.
-.
-Automatic  footnote  insertion.
-.
-This was handled somewhat awkwardly in the
-.FONT CB .DITTO
-.IR command ,
-although the basic approach was probably reasonable.
-.
-.
-.TP
-3.
-.
-Automatic page references, perhaps via some symbolic reference scheme.
-.
-This would enable the page number in "as was described on page 32" to
-be inserted by the program.
-.
-The analogy with an assembly program should be hotly pursued for
-ideas.
-.
-.
-.TP
-4.
-.
-Special provision for printing facing pages.
-.
-This would require alternate running heads, placing page numbers
-alternately at right and left, and matching line counts on facing
-pages.
-.
-.
-.TP
-5.
-.
-Improved page\-division rules, to prevent the last line of a paragraph
-appearing alone at the top of a page, for example.
-.
-At present, copy must be run off to check by hand that awkward page
-divisions have not been made.
-.
-.
-.TP
-6.
-.
-Automatic generation of page numbers for a table of contents.
-.
-Again, the analogy of an assembly program symbol table appears
-fruitful.
-.
-.
-.TP
-7.
-.
-Automatic generations of an index.
-.
-The problem here is obtaining too many references to a given word,
-many irrelevant.
-.
-.
-.TP
-8.
-.
-Arrangement of tabulated data.
-.
-This problem may have already been partly approached with the
-above\-described figure generator, or the facilities already available
-in
-.IR RUNOFF ,
-but automatic setup of column widths and positions would be desirable.
-.
-One could include in this category the ability to call on other
-programs to computer numbers to place in tables, although this is
-going pretty far afield.
-.
-.
-.TP
-9.
-.
-Placing figures in a
-.I "cut"
-or
-.IR inset .
-.
-The control language is the most difficult problem here.
-.
-.
-.TP
-10.
-.
-Equation typing and  numbering.
-.
-Again, the control language appears formidable.
-.
-.
-.\" --------------------------------------------------------------------
-.SH "SEE ALSO"
-.\" --------------------------------------------------------------------
-.
-.PP
-.\" BR RUNOFF (@MAN1EXT@),
-.BR groff (@MAN1EXT@),
-.BR groff (@MAN7EXT@),
-.BR roff (@MAN7EXT@),
-.BR groff_filenames (@MAN7EXT@)
-.
-.
-.TP
-.FONT R "1964 " CR "Jerome H. Saltzer" R :
-.nh
-.FONT CI "Jerome H. Saltzer \[em] TYPSET and RUNOFF, Memorandum editor and \
-type\-out commands"
-.hy
-available at
-.UR \%http://\:mit.edu/\:Saltzer/\:www/\:publications/\:CC\-244.html
-.UE
-.
-.
-.TP
-.FONT R "1965 " CR "Jerome H. Saltzer" R :
-.nh
-.FONT CI "Jerome H. Saltzer \(em Experimental Additions to the RUNOFF Command"
-available at
-.UR http://\:web.mit.edu/\:afs/\:athena.mit.edu/\:user/\:other/\
-\:a/\:Saltzer/\:www/\:publications/\:PSN\-40.html
-.UE
-.hy
-.
-.
-.TP
-.FONT R "1966 " CR "Jerome H. Saltzer" R :
-.nh
-.FONT CI "Jerome H. Saltzer \[em] Manuscript Typing and Editing"
-.hy
-which is available in the internet at
-.UR http://\:mit.edu/\:Saltzer/\:www/\:publications/\:AH.9.01.html
-.I MIT html
-.UE
-or
-.UR \%http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:ctss\/\:AH.9.01.html
-.I CTSS html
-.UE
-or
-.UR \%http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:ctss/\:AH.9.01.pdf
-.I CTSS pdf
-.UE .
-.
-.
-.TP
-.FONT R "1973 " CR "Larry Barnes" R :
-.FONT CI "Larry Barnes \[em] RUNOFF: A Program for the Preparation of Documents"
-available as
-.UR http://\:www.textfiles.com/\:bitsavers/\:pdf/\:sds/\:9xx/\:940/\
-\:ucbProjectGenie/\:mcjones/\:R\-37_RUNOFF.pdf
-.I pdf
-.UE .
-.
-.
-.TP
-.
-.P
-There is still more documentation by the
-.FONT CR "DEC PDP\-10 archive" R .
-.
-So far this information is not yet included, but it will be done later
-on.
-.
-.
-.P
-The latest
-.FONT CI RUNOFF
-documentation is file
-.FONT CB RUNOFF.DOC
-from 
-.FONT CR PDP\-11
-at 1981, see
-.FONT CR "SEE ALSO" R .
-.
-The content of this document is also included in this document.
-.
-.
-.P
-Look at section
-.FONT CR "SEE ALSO"
-for the internet connections to the documents.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Early Environment 1963\-66
-.\" --------------------------------------------------------------------
-.
-.FONT CI Saltzer
-originally worked on
-.IR \%MIT 's
-.I \%CTSS time-sharing operating
-.IR \%system .
-.
-There he had an editor
-.FONT CB TYPSET
-that he also documented in the documentation cited above.
-.
-This editor was an ancestor for
-.BR \%ed (@MAN1EXT@).
-.
-.
-.P
-To use his
-.FONT CI RUNOFF
-language, he programmed a tool that he called
-.FONT CB RUNOFF R .
-.
-.
-.P
-There is still an emulator and the old source files for
-.FONT CB RUNOFF
-and
-.FONT CB TYPSET
-at
-.nh
-.UR http://\:www.cozx.com/\:~dpitts/\:ibm7090.html 
-.FONT CR "IBM 7090 CTSS"
-.UE .
-.hy
-.
-.
-.\" --------------------------------------------------------------------
-.SS The original RUNOFF program 1963-66
-.\" --------------------------------------------------------------------
-.
-The original
-.FONT CB RUNOFF
-program is also documented in the documentation of 1966 above.
-.
-.
-.P
-.FONT CI Saltzer
-uses upper case
-.FONT CB RUNOFF
-to denote his program.
-.
-So we will also use 
-.FONT CB RUNOFF
-to refer to the original program of 1963-66.
-.
-.
-.P
-This program has mainly the task to adjust a printer of that time and
-then print a
-.FONT CI RUNOFF
-document with this configuration.
-.
-Today this does not make much sense, but some parts are still
-available in the options of
-.BR \%groff (@MAN1EXT@),
-but under different names.
-.
-So we will not build this ancient program, but we will document its
-old command line here.
-.
-A lower case program
-.FONT CB runoff
-will be something different.
-.
-.
-.P
-.FONT CB RUNOFF
-is a command used to type out files of the
-.FONT CI RUNOFF
-language in manuscript format.
-.
-.I Control words
-scattered in the text may be used to provide detailed control over the
-format.
-.
-Input files may be prepared by the context editor
-.FONT CB TYPSET
-which does not exist today.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Usage of RUNOFF Program
-\" --------------------------------------------------------------------
-.
-.SY RUNOFF
-.I \%filespec
-.RI [ "parameter \*[Ellipsis]" ]
-.YS
-.
-.
-.TP
-.I filespec
-is the primary name of a file to be typed out.
-.
-.TP
-.I parameter
-arguments are any number of the following parameters, in any order:
-.
-.
-.RS
-.
-.TP
-.FONT CB STOP
-Pause between pages.
-.
-.
-.TP
-.FONT CB NOWAIT
-Suppress the initial pause to load paper and the pause between pages
-(not necessary today).
-.
-.
-.TP
-.FONT CB PAGE I " n"
-Begin printing with the page numbered
-.IR n .
-.
-.
-.TP
-.FONT CB BALL I " n"
-Typewriter is using printing ball
-.IR n .
-If this parameter is omitted,
-.FONT CB RUNOFF
-assumes that the ball in use will properly print all
-.I CTSS characters
-in the file.
-.
-The number
-.I n
-is engraved on top of the printing ball.
-.
-.I CTSS characters
-not appearing on the ball being used will be printed as blanks, so
-that they may be drawn in.
-.
-This parameter does not make sense in our modern printers.
-.
-.RE
-.
-.
-.\" --------------------------------------------------------------------
-.SH THE ORIGINAL RUNOFF LANGUAGE OF 1966
-.\" --------------------------------------------------------------------
-.
-A
-.FONT CI RUNOFF
-file consists of
-.I command lines
-and
-.IR "text lines" .
-.
-The
-.I command lines
-start with a period (dot)
-.RB \(dq . \(dq,
-all other lines are
-IR "text lines" . 
-.
-.
-.P
-.I Command lines
-are also called
-.I command lines
-by
-.FONT CI Saltzer R .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Text Lines and Conditions
-.\" --------------------------------------------------------------------
-.
-.FONT CI RUNOFF
-.I text lines
-are different from the
-.FONT CI groff
-language.
-.
-.
-.P
-As the early
-.FONT CI CTSS
-computers could only produce upper case characters, the text lines
-look very strange today.
-.
-This wasn't documented in the documentation of the 1960s.
-.
-But there is a good documentation of 1981 which contains also the old
-style.
-.
-Have a look at chapter
-.FONT CI "RUNOFF ADDITIONS 1981"
-section
-.FONT CI "Case Information"
-in this document.
-.
-.
-.P
-One or more
-.I blank lines
-are not printed, but mean a
-.IR "line break" .
-.
-This can also be reached by the
-.FONT CB .BREAK
-.IR "control word" .
-.
-.
-.P
-In
-.IR groff ,
-blank lines are printed as lines of their own.
-.
-This is not a paragraph break, because a line is bigger than a
-paragraph break.
-.
-.
-.P
-A text line that starts with one or more space characters means
-.IR "begin a new paragraph" .
-.
-.
-.P
-In
-.IR groff ,
-this will start a new line and inserts the space characters at the
-beginning of the line.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Command Lines
-.\" --------------------------------------------------------------------
-.
-A command line begins with a period (dot)
-.RB \(dq . \(dq.
-.
-Following the dot
-.FONT CB RUNOFF
-expects a
-.IR "command name" .
-.
-This is called
-.I control word 
-by
-.FONT CI Saltzer
-.BI
-.
-.
-.P
-These
-.I command names
-or
-.I control words
-were defined by
-.FONT CI Saltzer
-as 1 or 2 words of arbitrary length.
-.
-or an
-.I abbreviation
-of defined 2 characters.
-.
-The later
-.FONT CI roff
-language uses only 2\-character requests; but
-.FONT CI groff
-expanded these to arbitrary length.
-.
-Each
-.I control word
-(1 or two words) can be written in upper or lower case as you like.
-.
-.
-.P
-Some
-.FONT CI "control words"
-are followed by a
-.I space
-and the
-.I parameters
-for that
-.IR command ,
-followed optionally by a comment (Comments are not documented
-further).
-.
-.
-.P
-Lines beginning with a dot but having an unrecognizable format are
-treated as errors.
-.
-.
-.P
-No lines beginning with a dot are printed unless the preceding line
-was a
-.I control line
-.FONT CB .LITERAL R .
-.
-All commands are described below.
-.
-Abbreviations for command names are normally based on the first two
-letters of a one word command or the first letter of the first two
-words of a multi\-word command.
-.
-Commands which should close a logical line break do.
-.
-Information on abbreviations and whether commands cause line breaks
-will be found in the summary at the end of the manual.
-.
-In a command line
-.FONT CB RUNOFF
-will consider multiple blanks as a single blank (space), if a blank
-character 1s legal.
-.
-.
-A
-.FONT CI RUNOFF
-document contains text separated by so\-called
-.IR "control words" .
-.
-As these are full lines, a better name would be
-.I "control lines"
-as is used in the documentation for
-.BR \%groff (@MAN7EXT@),
-.
-.
-.P
-These are lines starting with a period
-.RB ( . )
-and directly followed by a command with or without arguments.
-.
-The command names are arbitrarily long, they can even consist of
-several words, possibly followed by arguments.
-.
-.
-.P
-The
-.I "control words"
-can be written in lower or upper case, just as wanted.
-.
-Moreover, each command name can be shortened to an abbreviation of 2
-characters.
-.
-When the command name has only 1 word, the first 2 characters are taken.
-.
-.I Command names
-with 2 words abbreviate to the first character of each word.
-.
-These abbreviations led later to the 2 character
-.I \%requests
-of
-.IR \%roff .
-.
-.
-.P
-An example of a
-.I "control line"
-with a single
-.I "control word"
-with 2 arguments is a long name with lower case
-.IP
-.FONT CB .command I " arg1 arg2"
-.P
-or a long name with upper case
-.IP
-.FONT CB .COMMAND I " arg1 arg2"
-.P
-or an abbreviation with lower case
-.IP
-.FONT CB .co I " arg1 arg2"
-.P
-or an abbreviation with upper case
-.IP
-.FONT CB .CO I " arg1 arg2"
-.
-.
-.P
-Another example of a
-.I "control line"
-with 2
-.I "control words"
-with 1 argument is a long name with lower case
-.IP
-.FONT CB ".word1 word2" I " arg"
-.P
-or a long name with upper case
-.IP
-.FONT CB ".WORD1 WORD2" I " arg"
-.P
-or an abbreviation with lower case
-.IP
-.FONT CB .ww I " arg"
-.P
-or an abbreviation with upper case
-.IP
-.FONT CB .WW I " arg"
-.
-.
-.P
-These
-.I "control words"
-were renamed to
-.I requests
-later on in
-.FONT CI roff R .
-.
-.
-In the 1973 document, the words
-.I macros
-and
-.I formats
-are used without any documentation.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Control Words (Command Names, Requests)
-.\" --------------------------------------------------------------------
-.
-The documentation for
-.I "control words"
-in this paragraph are taken from the
-.FONT CI RUNOFF
-documentation of 1966.
-.
-Often this documentation refers to the
-.FONT CB RUNOFF
-program that doesn't exist any more.
-.
-When the
-.FONT CI RUNOFF
-language will be implemented for
-.BR \%groff (@MAN1EXT@)
-these documentations must be adjusted.
-.
-.
-.TP
-.FONT CB .ADJUST
-.TQ
-.FONT CB .AD
-Enable
-.I fill
-mode.
-.
-The next line is the first one affected.
-.
-This is the default mode.
-.
-.
-.TP
-.FONT CB .APPEND I " file"
-.TQ
-.FONT CB .AP I " file"
-Take as the next input line the first line of
-.IR \%file .
-.
-Note that the whole of 
-.I \%file
-is appended, and that the appending is an irreversible process \[em] that
-is, once
-.FONT CB RUNOFF
-encounters the
-.FONT CB .APPEND
-.I "control line"
-it will switch to the file
-.I \%file
-and continue from the first line of
-.IR \%file .
-.
-All lines following the
-.FONT CB .APPEND
-.I "control line"
-will not be processed by
-.FONT CB RUNOFF R .
-.
-The file
-.I \%file
-may, of course, itself call for appending of still another file, and
-so on.
-.
-.
-.TP
-.FONT CB ".BEGIN PAGE"
-.TQ
-.FONT CB .BP
-Print out this page, start next line on a new page.
-.
-.
-.TP
-.FONT CB .BREAK
-.TQ
-.FONT CB .BR
-The lines before and after the
-.FONT CB .BREAK
-.I "control word"
-will not be run together by the
-.FONT CI fill
-mode of operation.
-.
-.
-.TP
-.FONT CB .CENTER
-.TQ
-.FONT CB .CD
-The following line is to be centered between the left and right
-margins.
-.
-.
-.TP
-.FONT CB ".DOUBLE SPACE"
-.TQ
-.FONT CB .DS
-Copy is to be double spaced.
-.
-This mode  takes  effect after the next line.
-.
-.
-.TP
-.FONT CB .FILL
-.TQ
-.FONT CB .FI
-Enable
-.IR "fill mode" .
-.
-That means: Lengthen short lines by moving words from the following
-line; trim long lines by moving words to the following line.
-.
-This is the default mode.
-.
-.FONT CB .NOFILL
-disables the
-.I fill
-mode.
-.
-.
-.TP
-.FONT CB .HEADER I " word1 word2 \*[Ellipsis]"
-.TQ
-.FONT CB .HE I " word1 word2 \*[Ellipsis]"
-All of the line after the first blank is used as a header line, and
-appears at the top of each page, along with the page number, if
-specified.
-.
-.
-.TP
-.FONT CB ".HEADING MODE" I " arg"
-.TQ
-.FONT CB .HM I " arg"
-This
-.I control sequence
-alters the mode of the running head to that specified by the parameter
-.IR \%arg .
-.
-Any of the following parameters are allowed for
-.IR \%arg:
-.
-.
-.\"  --------------------------------------------------------------------
-.RS
-.
-.
-.TP
-.FONT CB CENTER
-The header will be centered on the page.
-.
-.
-.TP
-.FONT CB MARGIN
-The header will be adjusted against the right margin of the page.
-.
-.
-.TP
-.FONT CB FACING
-On even\-numbered pages, the header will be adjusted against the left
-margin, on odd numbered pages against the right.
-.
-.
-.TP
-.FONT CB OPPOSED
-The header will be adjusted against the opposite margin from the page
-number.
-.
-In the absence of a
-.FONT CB ".HEADING MODE"
-.IR "control sequence" ,
-the default option is
-.FONT CB .OPPOSED R .
-.
-.
-.RE
-.\"  --------------------------------------------------------------------
-.
-.
-.TP
-.FONT CB .INDENT I " n"
-.TQ
-.FONT CB .IN I " n"
-The argument
-.I \%n
-is a number.
-.
-Set the number of spaces to be inserted at the beginning of each line
-to
-.IR \%n .
-.
-Indent is preset to 0.
-.
-.
-.TP
-.FONT CB ".LINE LENGTH" I " n"
-.TQ
-.FONT CB .LL I " n"
-The argument
-.I \%n
-is a positive number.
-.
-Set the line length to
-.IR \%n .
-.
-The line length is preset to 60.
-.
-.
-.TP
-.FONT CB .LITERAL
-.TQ
-.FONT CB .LI
-The following line is not a
-.IR "control word" ,
-despite the fact that it begins with a period.
-.
-.
-.TP
-.FONT CB .NOFILL
-.TQ
-.FONT CB .NF
-Disable
-.IR "fill mode" .
-.
-That means: Print all lines exactly as they appear without right
-adjustment or filling out.
-.
-In
-.I NOFILL
-mode each input line produces one output line; further blank lines are
-output in this mode.
-.
-Use the
-.FONT CB .FILL
-.I control word
-to restart
-.IR filling .
-.
-.
-.TP
-.FONT CB .NOJUST
-.TQ
-.FONT CB .NJ
-Disable
-.IR "fill mode" .
-.
-.
-.TP
-.FONT CB ".ODD PAGE"
-.TQ
-.FONT CB .OP
-This
-.I "control word"
-causes the current page to be printed out, and the next page to be
-numbered with the next higher odd page number.
-.
-.
-.TP
-.FONT CB .PAGE R " [" I n R ]
-.TQ
-.FONT CB .PA R " [" I n R ]
-Print page numbers.
-.
-(The first page is not given a page number.
-.
-It has instead a two\-inch top margin.
-.
-See also
-.FONT CB "Manuscript Conventions" R ,
-below.)
-.
-If argument
-.I \%n
-is present, insert a page break and number the next page
-.IR \%n .
-Note that
-.FONT CB RUNOFF
-does not print completely empty pages.
-.
-.
-.TP
-.FONT CB ".PAGING MODE" I " arg1 arg2 \*[Ellipsis]"
-.TQ
-.FONT CB .PM I " arg1 arg2 \*[Ellipsis]"
-This
-.I control sequence
-alters the mode of page numbering to that specified by the arguments.
-.
-The arguments may be in any order, and must be selected from the
-following list:
-.
-.
-.\"  --------------------------------------------------------------------
-.RS
-.
-.
-.TP
-.FONT CB MARGIN
-Page numbers will be adjusted against the right margin.
-.
-.
-.TP
-.FONT CB FACING
-Odd page numbers are adjusted against the right margin, even page
-numbers are adjusted against the left margin.
-.
-.
-.TP
-.FONT CB CENTER
-Page numbers are centered between the right and left margin.
-.
-.
-.TP
-.FONT CB TOP
-Page numbers are placed on the fourth line from the top of the page.
-.
-.
-.TP
-.FONT CB BOTTOM
-Page numbers are placed on the fourth line from the bottom of the
-page.
-.
-.
-.TP
-.FONT CB OFF
-Page numbers are discontinued.
-.
-.
-.TP
-.FONT CB PREFIX I " \(dqstring\(dq"
-The string of characters between quotation marks is prefixed to the
-page number.
-.
-The quotation marks may be next to each other, in which case no prefix
-is used.
-.
-.
-.TP
-.FONT CB ROMANU
-Page numbers will be printed in upper case Roman numerals.
-.
-.
-.TP
-.FONT CB ROMANL
-Page numbers will be printed in lower case Roman numerals.
-.
-.
-.TP
-.FONT CB ARABIC
-Page numbers will be printed in Arabic.  (This is the normal mode.)
-.
-.
-.TP
-.FONT CB SET I " n"
-Set the next page number to be the positive number
-.IR \%n .
-.
-.
-.TP
-.FONT CB SKIP I " n"
-Skip
-.I \%n
-page numbers.
-.
-.
-.P
-If in a single use of
-.FONT CB ".PAGING MODE"
-several arguments specify competing functions, the last one specified
-takes precedence.
-.
-When the
-.FONT CB ".PAGING MODE"
-sequence appears in text at point A, all text up to A (and probably
-some text after A) will appear on a page controlled by the previous
-paging mode.
-.
-The new
-.I paging mode
-will take effect on the next page.
-.
-Then there is no danger of getting page numbers both at the top and
-bottom of the same page.
-.
-.
-.P
-Use of the
-.FONT CB TOP
-parameter may conflict with the
-.I \%heading
-.IR \%mode .
-.
-If a heading and a page number should be printed in the same column,
-the page number will take precedence.
-.
-In the absence of a
-.FONT CB ".PAGING MODE"
-.I control
-.IR sequence ,
-the default options are:
-.FONT CB "TOP MARGIN PREFIX \(dqPAGE\(dq" R .
-.
-.
-.RE
-.\"  --------------------------------------------------------------------
-.
-.
-.TP
-.FONT CB ".PAPER LENGTH" I " n"
-.TQ
-.FONT CB .PL I " n"
-This
-.I control word
-is used for running off a documentation file on non\-standard paper.
-.
-The number
-.I \%n
-is a line count, figured at 6 lines per inch.
-.
-If this
-.I control word
-is not given,
-.I n
-is assumed to be 66, for 11\-inch paper.
-.
-.
-.TP
-.FONT CB ".SINGLE SPACE"
-.TQ
-.FONT CB .SS
-Copy is to be single spaced.
-.
-This mode takes effect after the next line.
-.
-(The normal mode is single space.)
-.
-.
-.TP
-.FONT CB .SPACE R " [" I n R ]
-.TQ
-.FONT CB .SP  R " [" I n R ]
-Insert
-.I \%n
-vertical spaces (carriage returns) in the copy.
-.
-If
-.I \%n
-carries spacing to the bottom of a page, spacing is stopped.
-.
-If
-.I \%n
-is absent or 0, one space is inserted.
-.
-.
-.TP
-.FONT CB .UNDENT I " n"
-.TQ
-.FONT CB .UN I " n"
-In an indented region, this
-.I control word
-causes a break, and the next line only will be indented n spaces fewer
-than usual.
-.
-This
-.I "control word"
-is useful for typing indented numbered paragraphs.
-.
-.
-.\" --------------------------------------------------------------------
-.SH RUNOFF ADDITIONS 1973
-.\" --------------------------------------------------------------------
-.
-Here are described only the additional
-.I control words
-that are documented in the 1973 documentation.
-.
-.\" --------------------------------------------------------------------
-.SS Formats
-.\" --------------------------------------------------------------------
-.
-.
-.TP
-.FONT CB .FORMAT I " name"
-This command causes subsequent text to be output under the control of
-tne specified format (see below at
-.FONT CB ".DEFINE FORMAT" R ).
-.
-Each following logical line will be fit into the format until a
-.FONT CB .FILL
-or
-.FONT CB .NOFILL
-command 1s encountered.
-.
-.
-.TP
-.FONT CB ".DEFINE FORMAT" I " <name> <pos> <field_ definition> \
-\*[Ellipsis]"
-.TQ
-.FONT CB ".END FORMAT"
-These commands define a format for use in producing tables, etc.
-.
-.
-.RS
-.
-.
-.TP
-.I <name>
-identifies the format.
-.
-It can be activated by the
-.FONT CB .FORMAT
-.IR command .
-.
-.
-.TP
-.I <pos>
-is the position and may be one of
-.FONT CB LEFT R ,
-.FONT CB RIGHT R ,
-or
-.FONT CB CENTER R ,
-and determines the overall positlon of the format with respect to the
-margins.
-.
-.
-.TP
-.I <field_definition>
-There can be several arguments of this type.
-.
-Each has the form:
-.
-.
-.RS
-.
-.FONT CI <type> CB ( CI "<letter> \*[Ellipsis] <letter>" CB )
-.
-.P
-where the
-.FONT CI <type>
-is one of
-.
-.TP
-.FONT CB L
-for left,
-.
-.TP
-.FONT CB R
-for riqht,
-.
-.TP
-.FONT CB C
-for center,
-.
-.TP
-.FONT CB F
-fer fill, or
-.FONT CB J
-for justify.
-.
-.
-.P
-The first three types define fixed fields; the text to be formatted
-must fit within the allocated space.
-.
-The latter types define variable fields; the text will be handled as
-in normal fill mode processing.
-.
-.
-.P
-A picture showing the manner in which text should be output follows
-the
-.FONT CB ".DEFINE FORMAT"
-command; following the picture should be an
-.FONT CB ".END FORMAT"
-command.
-.
-The following lines give an example:
-.
-.
-.RS
-.  ft CB
-.  nf
-.  nh
-.    nop ".DEFINE FORMAT SUMMARY L(A) F(C) C(B)"
-.    nop "AAAA	CCCCCCCCCCCCCCCCCCCCCCCCC	BBBBBBB"
-.    nop "	CCCCCCCCCCCCCCCCCCCCCCCCC		"
-.    nop ".END FORMAT"
-.  hy
-.  fi
-.  ft
-.RE
-.
-.
-.P
-The first field of text is left justified; the second is centered; the
-third is subjected to
-.I fill mode
-processing without justification.
-.
-After the first line of output is generated using this format, all
-subsequent lines are produced using the last picture 1ine.
-.
-(Strictly speaking the third line is unnecessary.)
-.
-.
-.P
-Text for formatted processing consists of a logical line (or
-paragraph).
-.
-Each field except the last must be separated by
-.IR tab .
-.
-The
-.I tab character
-is displayed here as backslash character
-.FONT R ( CB \[rs] R ).
-.
-.
-.P
-The first field of text is
-.FONT CB A R ,
-the second
-.FONT CB B R ,
-etc.
-.
-Typical input for our example might be:
-.
-.
-.RS
-.nf
-.nh
-|A\\YES\\/THIS IS SOME TEXT
-TO BE FILLED.
-.hy
-.fi
-.RE
-.
-.
-.P
-The characters 1n the picture lines were 1nterpreted as follows.
-.
-Contiguous sequences of letters determine the fie1d positions;
-non\-alphabetic characters are output literally.
-.
-(Note:
-.FONT CB Q.QQ
-wi11 not work, put the period
-.RB \[dq] . \[dq]
-in the text.
-.
-A sequence of characters written between double quotes is considered
-literal text.
-.
-The
-.I double quotes
-are not output, and there is no way to use
-.I double quote
-as a
-.IR literal .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Hyphenation Processing
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .HYPHENATE
-Enable
-.IR "hyphenation mode" .
-.
-This is the default when starting up.
-.
-The
-.FONT CB RUNOFF
-program used a small
-.I glossary
-for splitting.
-.
-In
-.I hyphenation mode
-.FONT CB RUNOFF
-would try to find a word 1n the glossary which is the same (except for
-the endings
-.FONT CB \-S R ,
-.FONT CB \-ES R ,
-.FONT CB \-ED R ,
-and
-.FONT CB \-E R )
-as the word at the end of the line of text.
-.
-When running in
-.BR groff (1)
-there are
-.I glossaries
-being much more complete than in
-.BR RUNOFF .
-.
-.
-.TP
-.FONT CB .NOHYPHEN
-Disable
-.IR "hyphenation mode" .
-.
-.
-.TP
-.FONT CB .GLOSSARY I " word"
-This command inserts words into the
-.I glossary
-for use in
-.IR hyphenation .
-.
-Each word should have the form
-.FONT CB hy\[hy]phen\[hy]ate
-and be separated by spaces.
-.
-.
-.TP
-.FONT CB ".HYPHENATION BREAK" I " n"
-This command set the parameter which determines the allowable number
-of spaces to te inserted in a line before
-.FONT CB RUNOFF
-tried to hyphenate the last word.
-.
-Each space counts ten points.
-.
-If more than
-.I n
-points per word would have to be inserted, then
-.I hyphenation
-will be attempted.
-.
-The initial setting of this parameter is 5 (one\-half space per word).
-.
-.
-.\" --------------------------------------------------------------------
-.SS Margin Controls
-.\" --------------------------------------------------------------------
-.
-There are two types of margins involved in
-.FONT CI RUNOFF R .
-.
-.
-.TP
-(1)
-The physical margins.
-.
-These are determined by the nature of the printing device.
-.
-The margins outline the area where it is physically possible to print
-characters.
-.
-.
-.TP
-(2)
-.
-The logical margins.
-.
-These can be set bv the user as he wishes.
-.
-(Limits are imposed by the physical margins.)
-.
-They are initialized for standard 8.5\[dq] by 11\[dq] printing.
-.
-.
-.P
-Commands concerning vertical and horizontal margins are:
-.
-.
-.TP
-.FONT CB ".PAGE LAYOUT TM, EM, TOL"
-This sets the vertical logical margins and vertical tolerence.
-.
-Parameters are top margin, bottom margin and tolerance.
-.
-The tolerance is used to determine where to break between pages on
-page overflows.
-.
-If
-there is a line break within
-.I TCL lines
-of the bottom,
-.FONT CB RUNOFF
-will break the page there; otherwise it will fill the page completely.
-.
-.
-.TP
-.FONT CB ".LINE LAYOUT LM, RM, NO, CS"
-This sets the logical left and right margin, the number of columns,
-and the number of spaces to insert between columns.
-.
-These margins are used for the page headings.
-.
-To adjust the relative
-text position, use the subsequent commands.
-.
-.
-.TP
-.FONT CB ".REDUCE MARGIN LM, RM"
-.TQ
-.FONT CB ".EXPAND MARGIN LM, RM"
-.TQ
-.FONT CB ".END REDUCTION"
-These commands enable the user to indent a certain portion of his text
-using the first command, or
-.FONT CB .UNDENT
-his text using the second command.
-.
-In either case the original margins are restored by the third command.
-.
-The use of several
-.FONT CB ".REDUCE MARGIN"
-commends before the corresponding
-.FONT CB ".END REDUCTION"
-commands succesively indents the text more, and more.
-.
-Thus these commands are 1ike brackets (i.e. recursive).
-.
-.FONT CB LM
-is added to the left logical margin and
-.FONT CB RM
-is subtracted from the right logical margin in the first command.
-.
-Just
-the opposite is done on the second command.
-.
-Negative numbers are permitted.
-.
-These commands do not effect the position of page headings.
-.
-.
-.TP
-.FONT CB ".LAYOUT PLM, PRM, PTM, PBM, LL, LO"
-This command defines the physical margins in the followinq complex
-manner.
-.
-(It should only be used for non\-standard devices, normally this
-command should not be necessary.)
-.
-The parameters are the physical left margin (in spaces), the physical
-right margin, the physical top 1ine, the physical bottom line, the
-line lenqth, and line origin.
-.
-The first four parameters define the physical 1imits of the printing
-device.
-.
-The final two parameters define the length of the logical line and its
-origin with respect to the left edge of the paper.
-.
-Printing starts at column
-.FONT CB "LO + LM" R ,
-and ends at
-.FONT CB "LO + RM" R ,
-where
-.FONT CB LM
-and
-.FONT CB RM
-are the logical margins established by
-.FONT CB ".LINE LAYOUT" R .
-.
-When using the
-.FONT CI "facing feature"
-(see
-.FONT CB ".PAGING MODE" R ),
-the logical left margin is
-.FONT CB "LL \[em] RM"
-on even pages, and the right margin is
-.
-.FONT CB "LL \[em] LM" R .
-.
-The parameters for the layout command must satisfy:
-.
-.RS
-.RS
-.nh
-.nf
-.ft CB
-.nop "min(LO + LL \[em] PLM, PRM \[em] LO) > max(PLM \[em] LO, \
-LO + LL \[em] PRM)\f[],\f[CB]"
-.nop LL > 25\f[], and \f[CB]PBM \[em] PTM > 6\f[]
-.fi
-.hy
-.RE
-.
-.
-.P
-This command sets
-.FONT CB LM
-to 15,
-.FONT CB RM
-to
-.FONT CB "LL \[em] 10" R ,
-.FONT CB TM
-to
-.FONT CB PTM R ,
-and
-.cb BM
-to
-.FONT CB "PBM \[em] 6" R .
-.
-(These margin settings produce the standard 1.5 inch left, and 1 inch
-right, too, and bottom margins.)
-.
-.RE
-.
-.
-.P
-Initially
-.FONT CB RUNOFF
-sets the margins for
-.I teletype
-output to:
-.
-.
-.RS
-.RS
-.nh
-.nf
-.ft CB
-.nop .LAYOUT 6, 89, 6, 66, 8S, 0
-.nop .LINE LAYOUT 15, 75
-.nop .FILL
-.ft
-.fi
-.hy
-.RE
-.RE
-.
-.
-.P
-The printer layout is:
-.
-.RS
-.RS
-.nh
-.nf
-.ft CB
-.nop ".layout 5, 137, 6, 66, 85, 15"
-.nop ".page layout 6, 60, 4"
-.ft
-.fi
-.hy
-.RE
-.RE
-.
-.P
-The logical margins must satisfy:
-.
-.RS
-.RS
-.nh
-.nf
-.ft CB
-.nop min(LL, PRM \[em] LO, LO \[em] LL \[em] PLM) >= RM >
-.nop "     LM >= max(0, PLM \[em] LO, LO + LL \[em] PRM)" \f[],\f[CB]
-.nop "PBM >= BM > TM >= PTM" "\f[], and\f[CB]"
-.nop BM \[em] TM > TOL\f[].
-.fi
-.hy
-.RE
-.RE
-.
-.
-.\" --------------------------------------------------------------------
-.SS Paragraph Formatting
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB ".PARAGRAPH SPACING" I " n"
-.
-This specifies how many lines are to be inserted between paragraphs.
-.
-Initial setting = 1.
-.
-.
-.TP
-.FONT CB ".PARAGRAPH INDENTATION" I " n"
-This specifies how many additional spaces to insert at the beginning
-of a paragraph.
-.
-Initial setting = 5.
-.
-.
-.TP
-.FONT CB ".PARAGRAPH UNDENTATION" I " n"
-This command is the same as
-.FONT CB ".PARAGRAPH INDENTATION" I " \-n" R .
-.
-That is,
-.I n
-fewer spaces are inserted at the beginning of the paragraph.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Special Line Justification and Control
-.\" --------------------------------------------------------------------
-.
-These commands pertain to the next logical line.
-.
-The end of the line should be designated with a break.
-.
-.
-.TP
-.FONT CB .CENTER
-.
-Center the next line.
-.
-.
-.TP
-.FONT CB .INDENT I " n"
-.
-Indent the next line
-.I n
-spaces.
-.
-If
-.I n
-is not provided, 5 is assumed.
-.
-.
-.TP
-.FONT CB .UNDENT I " n"
-.
-Start the next line
-.I n
-spaces to the left of the normal margin.
-.
-This command is the same as
-.FONT CB .INDENT I " \-n" R .
-.
-.
-.TP
-.FONT CB .MARGIN
-Justify the next 1ine against the right hand margin.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Heading and Paging
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .HEADER I " XXXXXXX"
-.FONT CB RUNOFF
-accepts a heading to go on the first line of
-each paqe.
-.
-The heading strinq is assured to start at the first non\-blank
-character after thd control word and end at carriage return.
-.
-.
-.TP
-.FONT CB ".HEADING MODE" I " <param>"
-.I <param>
-determines the position of the heading on the 11ne.
-.
-.I <param>
-may be any of the following.
-.
-.
-.RS
-.
-.TP
-.FONT CB CENTER
-The header will be centered on the 1ine.
-.
-.
-.TP
-.FONT CB MARGIN
-The header will be adjusted against the riqht margin.
-.
-.
-.TP
-.FONT CB PAGING
-On even numbered pages tne header is adjusted against the right
-margin.
-.
-On odd pages it is adjusted against the left mergin.
-.
-.
-.TP
-.FONT CB OPPOSED
-The header will be adjusted against the opposite margin from the
-page numter.
-.
-This is the initial mode.
-.
-.RE
-.
-.
-.TP
-.FONT CB ".PAGING MODE" I " <param>"
-.
-This command determines the placing of the page number.
-.
-All parameters are optional.
-.I <param>
-may be anyone or more of the following oommands.
-.
-In case of conflict the latest command wins.
-.
-.RS
-.
-.TP
-.FONT CB CENTER
-The page numbers are centered between the logical margins.
-.
-.TP
-.FONT CB MARGIN
-The page number is adjusted against the right margin.
-.
-.TP
-.FONT CB FACING
-On even numbered pages the number will be adjusted against the right
-margin.
-.
-On odd numbered pages tne number will be adjusted against the
-left margin.
-.
-.TP
-.FONT CB TOP
-Page numbers are placed on the first line.
-.
-.TP
-.FONT CB BOTTOM
-Page numbers are placed on the last line.
-.
-.TP
-.FONT CB OFF
-Printing page numbers is discontinued.
-.
-.TP
-.FONT CB PREFIX I " <string>"
-.TQ
-.FONT CB SECTION I " <string>"
-.TQ
-.FONT CB SUFFIX I " <string>"
-The strings of characters between quotation marks are used to form the
-page. string, which has the form:
-.
-.RS
-.I <prefix><section><page number><suffix>
-.
-.P
-Any or all of these strings mav be null.
-.
-The section string is considered to be part of the page number for
-purposes of indexing.
-.
-.RE
-.P
-Initial mode is:
-.
-.RS
-.RS
-.ft CB
-.nop ".PAGING MODE TOP MARGIN PREFIX \[dq]Page\[dq]"
-.nop ".PAGING MODE SECTION \[dq]\[dq] SUFFIX \[dq]\[dq]"
-.RE
-.RE
-.
-.
-.P
-If neither page number nor heading is used, the text will start on the
-first logical line.
-.
-Otherwise it will start on the fourth logical line.
-.
-If the page number is at the bottom, text will end on the fourth line
-from the bottom.
-.
-If the paging and headinq mode conflict, the page string overwrites
-the heading.
-.
-.RE
-.
-.
-.TP
-.FONT CB ".ODD PAGE"
-This
-.FONT CI "control word"
-causes the ourrent page to be printed out and the next page to be
-started with the next higher odd number.
-.
-.
-.TP
-.FONT CB .PAGE I " n"
-If
-.I n
-is present, insert a page break and start numbering the next pege
-with
-.IR n .
-Otherwise, turn the
-.I paging mode
-on and do not insert a page break.
-.
-.
-.TP
-.FONT CB .EJECT I " n"
-Insert a page break if either there are fewer than
-.I n
-lines left on the page or
-.I n
-is not present.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Lines and Spacing
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB ".SINGLE SPACE"
-Sing1e space all 1ines within paragraphs.
-.
-This is the initial state.
-.
-.
-.TP
-.FONT CB ".DOUBLE SPACE"
-Double space all lines within paragraphs.
-.
-.
-.TP
-.FONT CB .SPACE I " n"
-Output
-.I n
-1ine spaces.
-.
-If
-.I n
-is not provided, 1 is assumed.
-.
-In case of page overflow all remaining blank 1ines to be output are
-deleted.
-.
-.
-.TP
-.FONT CB ".FIGURE SPACING" I " n"
-This command is equivalent to
-.FONT CB .EJECT I " n"
-followed by
-.FONT CB .SPACE
-.IR n .
-.
-These commands provide the only means of creatinq blank 11nes.
-.
-.
-.TP
-.FONT CB .BREAK
-The lines before and after this command will not be run together in
-.IR "fill mode" .
-.
-A simpler way to get a line break is to insert one or more blank lines
-in the text.
-.
-.
-.TP
-.FONT CB ".BEGIN GROUP"
-.TQ
-.FONT CB ".END GROUP"
-The output lines enclosed between these two commands are forced to lie
-on a page.
-.
-Thus this command acts in a manner similar to
-.FONT CB .EJECT I " n" R ,
-where
-.I n
-has the 'right' value.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Miscellanous
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .UNDERLINE
-The following 1ine is underlined.
-.
-.
-.TP
-.FONT CB .LITERAL
-The next line is taken as part of text whether or not
-it begins with dot.
-.
-.
-.TP
-.FONT CB .ESCAPE I <char>
-.TQ
-.FONT CB .SHIFT I <char>
-.TQ
-.FONT CB ".TAB CHARACTER" I <char>
-The given character becomes the
-.IR escape ,
-.IR shift ,
-or
-.I tab
-character.
-.
-The parameter for the
-.FONT CB .SHIFT
-and
-.FONT CB ".TAB CHARACTER"
-commands may be null, if no
-.I shift
-or
-.I tab
-character is desired.
-.
-.
-.TP
-.FONT CB ".DEFINE COMMAND" I " <name>"
-.TQ
-.FONT CB ".END COMMAND"
-.TQ
-.FONT CB .CALL I " <name>"
-These commands give the user the opportunity to combine text and
-control lines to form his own commands.
-.
-All text and command lines between the first and second commands is
-stored away under
-.IR name .
-.
-When the third command is executed, the stored string is read and the
-commands within the string are executed.
-.
-Recursion is not permitted.
-.
-.
-.TP
-.FONT CB .INDEX I " <phrase>, <phrase>"
-.
-.FONT CB RUNOfF
-saves the first phrase in the main index table and the second phrase
-(if any) in a sub\-index table associated with the first phrase.
-.
-.RS
-.
-The index is formatted and output after the last page of text.
-.
-Two built\-in but redefinable formats,
-.FONT CI RINDEX
-and
-.FONT CI SINDEX R ,
-are used to format the index as shown in the following example.
-.
-.RS
-.nh
-.nf
-.FONT CB "Algorithms, 40, 78," R "             \[rs]\[dq] uses " I RINDEX
-.FONT CB "  analysis of, 27, " R "             \[rs]\[dq] uses " I SINDEX
-.fi
-.hy
-.RE
-.
-.
-The following lines give the initial definitions for the indexing
-formats.
-.
-.
-.RS
-.nh
-.nf
-.ft CB
-.nop ".define format RINDEX f(A)"
-.nop "AAAAAAAAAAAAAAAAAAAAAAAAAAA"
-.nop "    AAAAAAAAAAIAAAAAAAAAAAA"
-.nop ".end format"
-.nop ".define format SINDEX f(A)"
-.nop "  AAAAAAAAAAAAAAAAAAAAAAAAA"
-.nop "    AAAAAAAAAAIAAAAAAAAAAAA"
-.nop ".end format"
-.ft
-.fi
-.hy
-.RE
-.
-.
-In order to get an index output in two columns,
-.RS
-.P
-.FONT CB ".LINE LAYOUT 15, 75, 2, 4"
-.P
-should be the last line of the input.
-.RE
-.
-.RE
-.
-.
-.\" --------------------------------------------------------------------
-.SH RUNOFF DOCUMENTATION 1974
-.\" --------------------------------------------------------------------
-.
-This document is the best documentation about text lines.
-.
-Parts of that is used in the document of 1981.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Command Lines
-.\" --------------------------------------------------------------------
-.
-All lines beginning with a period (dot) are
-.FONT CI RUNOFF
-command lines.
-.
-All other lines are text lines.
-.
-.
-.P
-A command line consists of a period, following by a command, which can
-consist of one or more words, or a 2- or 3-letter abbreviation,
-followed by 0 or 1 or more arguments.
-.
-This can be followed by a comment, which is preceeded by an
-exclamation point (bang character)
-.FONT CB ! R .
-.
-In ancient 
-.FONT CI RUNOFF R ,
-The comment didn't need to be preceeded.
-.
-.
-.P
-In this document, several command or text lines can be appended into a
-multiple line if these parts are separated by a semi-colon
-.FONT CB ; R .
-.
-If 2 commands are appended, the semi-colon may be omitted, because the
-period is a sufficient separator.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Text Lines
-.\" --------------------------------------------------------------------
-.
-.P
-There are 2 modes of text line structures:
-.
-.
-.TP
-.I ancient style
-This is the original style.
-.
-Due to very old hardware, there were only input methods for upper case
-characters.
-.
-But typewriters and printers were able to use both upper and lower case.
-.
-So the text lines are all in upper case with special characters that
-are case-shifters for the printing.
-.
-.
-.TP
-.I newer style
-By better hardware, it was possible to use input methods with both
-upper and lower case.
-.
-Here the text lines are like those in later
-.FONT CI roff
-and
-.FONT CI groff
-mode.
-.
-.
-.P
-This paragraph describes only the
-.I ancient style
-of text lines.
-.
-.
-.P
-This text is filled and justified such as with the later
-.FONT CI roff
-language.
-.
-Just as in
-.FONT CI roff R ,
-the filling, justification, and line break can be turned on or off by
-commands.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Case Changing of Text Lines
-.\" --------------------------------------------------------------------
-.
-In this section, the specification of case for files prepared on an
-upper case terminal is documented.
-.
-There are special characters that in printing act as case-shifters for
-ASCII characters into lower (ASCII code 97 to 122 decimal) or upper
-case (ASCII code 65 to 90 decimal).
-.
-.
-.P
-The lower case mode seems to be the default mode.
-.
-Also, according to existing old
-.FONT CI RUNOFF
-files, each text line starts with this default mode.
-.
-.
-.TP
-.FONT CI "single circumflex " CB ^
-The following ASCII character is shifted into upper case.
-.
-.
-.TP
-.FONT CI "single back\-slash " CB \[rs]
-The following ASCII character is shifted into lower case.
-.
-.
-.TP
-.FONT CI "double circumflex " CB ^^
-The case mode is shifted into upper case.
-.
-.
-.TP
-.FONT CI "double back\-slash " CB \[rs]\[rs]
-The case mode is shifted into lower case.
-.
-.
-.P
-A common example with starting mode in lower case for these 4 special
-characters is:
-.
-.P
-.RS
-^HERE IS A ^SAMPLE ^SENTENCE IN ^^UPPER CASE\\ AND LOWER CASE.
-.RE
-.
-.P
-is printed as:
-.
-.RS
-Here is a Sample Sentence in UPPER CASE and lower case.
-.RE
-.
-.
-.\" --------------------------------------------------------------------
-.SS Further special Characters in Text Lines
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CI "ampersand " CB &
-This is used for underscoring the next following character.
-.
-For example:
-.
-.RS
-.P
-.RS
-&s&o&f&t&w&a&r&e
-.RE
-.
-.P
-becomes:
-.RS
-.UL software
-.RE
-.
-.P
-in the output or printing.
-.RE
-.
-.
-.TP
-.FONT CI "circumflex and ampersand " CB ^&
-This is used for underscoring all following characters except for
-blanks.
-.
-.
-.\" --------------------------------------------------------------------
-.SH RUNOFF ADDITIONS 1981
-.\" --------------------------------------------------------------------
-.
-.\" --------------------------------------------------------------------
-.SS Source File Format
-.\" --------------------------------------------------------------------
-.
-The source file contains the textual material which will appear on the
-final copy, plus information to specify formatting.
-.
-Most importantly, upper and lower case information also may be
-supplied so that copy can be prepared on the terminal or other such
-device which can input only upper case letters.
-.
-All command information consists of regular
-.FONT CI ASCII
-printing characters so that a listing of the source file may be
-examined if the final copy is not exactly as desired.
-.
-.
-.P
-All material in the source file is taken to be source text except
-those lines beginning with a period.
-.
-A line beginning with a period is assumed to be a command, and must
-match one of those listed below.
-.
-The commands provide the formatting information, and control various
-optional modes of operation.
-.
-.
-.P
-Usually the text is
-.I filled
-and
-.I justified
-as it is processed.
-.
-That is, the program
-.I fills
-a line by adding successive words from the source text until one more
-word would cause the right margin to be exceeded.
-.
-The line is then
-.I justified
-by making the word spacings larger until the last word in the line
-exactly meets the right margin.
-.
-.
-.P
-The user may occasionally wish to reproduce the source text exactly,
-which is done by disabling
-.I filling
-and
-.I justification
-or by use of the
-.FONT CR .LITERAL
-command.
-.
-The program may be set to
-.I fill
-but not
-.IR justify ,
-in which case the output will be normal except that lines will not be
-justified to the right margin.
-.
-The program may also be set to
-.I justify
-but not
-.IR fill ,
-although this would probably produce peculiar results and is not
-recommended.
-.
-.
-.P
-When the
-.I fill mode
-is on, spaces and carriage returns occurring in the source text are
-treated only as word separators.
-.
-Multiple separators are ignored.
-.
-.
-.P
-Some of the commands cause a BREAK in the output.
-.
-A
-.I break
-means that the current line is output without justification, and the
-next word goes at the beginning of the next line.
-.
-This occurs at the end of paragraphs.
-.
-.
-.P
-The program will advance to new pages as necessary, placing the title
-(if given) and the page number at the top of each page.
-.
-The user may call explicitly for a
-.I page advance
-where desired, and may inhibit the occurrence of a
-.I page advance
-within specified material.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Case Information of Text Lines
-.\" --------------------------------------------------------------------
-.
-The information in this section documents the style of the text lines
-that could only be upper case in the ancient
-.FONT CI CTSS
-computers of the early 1960s..
-.
-It seems as if this section documents the old
-.FONT CI RUNOFF
-style.
-.
-.
-.P
-Specification of
-.I case
-for files prepared on the terminal is done with two characters,
-circumflex 
-.FONT R ( CB ^ R , CI " 136 octal" R ),
-and
-.FONT CR back\-slash R " (" CB \[rs] R , CI " 134 octal" R ).
-The appearance of a circumflex causes the letter immediately following
-to be transmitted in upper case.
-.
-The appearance of a
-.FONT CR back\-slash
-causes the letter immediately following to be converted to lower case.
-.
-Any letter not preceded by one of these characters is transmitted in
-the current mode.
-.
-.
-.P
-The mode is initially
-.I "upper case"
-.FONT CB (wrong!) R .
-.
-(The initial mode seems to be
-.IR "lower case" .
-.
-That's the style used by the available
-.FONT CI RUNOFF
-files in the PDP-10 archive and by the example below.
-.
-And each newline seems to switch back to the initial mode, well:
-.IR "lower case" ). 
-.
-.
-.P
-The mode is changed by the occurrance of two successive
-.I case
-control characters.
-.
-Two
-.FONT CR circumflexes
-.FONT CB ^^
-cause the mode to be set to
-.IR "upper case" ,
-and two
-.FONT CR back\-slashes
-.FONT CB "\[rs]\[rs]"
-cause the mode to be set to
-.IR "lower case" .
-.
-.
-.P
-The use of the above corresponds to the use of the
-.FONT CR shift
-and
-.FONT CR shift\-lock
-keys on a typewriter.
-.
-Usually, typing appears in
-.IR "lower case" .
-To type one letter in
-.IR "upper case" ,
-the
-.FONT CR shift
-.I key
-is used.
-.
-The
-.FONT CR shift\-lock
-is set to type a series of
-.IR "upper case letters" ,
-after which it is released.
-.
-.
-.P
-The following shows the uses of the case control characters:
-.EX
-^HERE IS A ^SAMPLE ^SENTENCE IN ^^UPPER CASE\[rs]\[rs] AND LOWER CASE.  
-.EE
-becomes:
-.EX
-Here is a Sample Sentence in UPPER CASE and lower case.
-.EE
-.
-.
-.RS
-.P
-.ce
-NOTE
-.
-.P
-Case conversion takes place only on
-.FONT CI ASCII
-.I " codes"
-.FONT CR 101
-to
-.FONT CR "132 octal" R ,
-that is, the
-.I upper case
-letters.
-.
-Any actual
-.I lower case
-letters (codes
-.FONT CR 141
-to
-.FONT CR "172 octal" R )
-appearing in the source will be transmitted unchanged.
-.
-If the source is prepared on a device such as a
-.FONT CI DECwriter
-or model
-.FONT CI "37 Teletype"
-which produce letters of the proper
-.IR case ,
-the mode should be set to
-.I upper case
-at the beginning of the file and left unchanged for the remainder.
-.RE
-.
-.
-.P
-An additional character,
-.FONT CR less\-than
-.FONT R ( CR < R ,
-.FONT CR "074 octal" R ),
-capitalizes the entire word it precedes.
-.
-It then returns the file to the current
-.IR case .
-.
-This character is not engaged unless preceded by the
-.nh
-.FONT CB ".FLAGS CAPITALIZE"
-.hy
-.IR command .
-.
-Similarly, the
-.nh
-.FONT CB ".FLAGS HYPHENATE"
-.hy
-.I command
-engages the special character
-.FONT CR equals
-.FONT R ( CB = R , CR "075 octal" R ),
-which causes
-.I hyphenization
-to be suspended for the word it precedes.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Special Characters
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB & CI " Ampersand    " CR Underscoring
-The character
-.FONT CI ampersand
-.FONT R ( CB & R ,
-.FONT CR "046 octal" R )
-is used to specify
-.UL underscoring .
-.
-The
-.FONT CI ampersand
-will cause the character following it to be
-.IR underscored ,
-e.g.
-.FONT CB &f&o&o
-becomes
-.UL \f[CB]foo\f[] .
-.
-.
-.P
-Underlining of a string of characters can also be specified in a
-manner similar to that of the
-.CI shift lock
-operations described above.
-;
-An appearance of
-.FONT CI ampersand
-preceded by
-.FONT CI circumflex
-.FONT CB ^&
-will cause underlining of all following characters except space.
-.
-An appearance of
-.CI ampersand
-preceded by
-.CI back\-slash
-.FONT CB \[rs]&
-will disable this mode.
-.
-.
-.TP
-.FONT CB # CR "  Number Sign  " I "Explicit space"
-It is occasionally necessary to include
-.I spaces
-in the text which should not be treated as
-.IR "word separators" .
-.
-For this purpose,
-.FONT CI RUNOFF
-treats the
-.I number\-sign
-character
-.FONT R ( CB # R ,
-.FONT CR "043 octal" R )
-as a
-.IR "quoted space" ;
-i.e.  it will print as exactly one
-.I space
-in the output, will never be expanded nor changed to a
-.IR "carriage return" .
-.
-.
-.TP
-.FONT CB _ CR "  Underline   " I "Quote next character"
-To allow the appearance of the
-.I special characters
-.FONT R ( CI ampersand
-used as a
-.IR "quote character" .
-.
-The character immediately following an
-.FONT CR underscore
-will be transmitted to the output with no formatting effect.
-.
-The
-.FONT CR underscore
-itself is thus another
-.IR "case requiring quoting" .
-.
-The following five cases occur:
-.FONT CB _& R ,
-.FONT CB _^ R ,
-.FONT CB _\[rs] R ,
-.FONT CB __ R ,
-.FONT CB _# R ,
-.FONT CB _{ R ,
-.FONT CB _} R ,
-and
-.FONT CB _| R .
-.
-.
-.TP
-.FONT CB ^ CI "   Circumflex   " I "Upper\-case shift or mode lock"
-As described above, the
-.FONT CI circumflex
-character
-.FONT CB ^
-is used to convert the letter following to
-.IR upper\-case .
-It is also used to lock the
-.I case mode
-in
-.IR "upper case" ,
-and the
-.I underline mode
-to
-.UL "underline all text" .
-.
-If it is to appear in the printed text, it must be preceded by the
-.I quote character
-.FONT CB _^ R .
-.
-.
-.TP
-.FONT CR \[rs] CI "  back\-slash  " I "lower\-case shift or mode unlock"
-As described above, the
-.FONT CI back\-slash
-character
-.FONT CB \[rs]
-is used to output the letter following in
-.IR lower\-case .
-.
-It is also used to lock the
-.I case mode
-in
-.IR lower\-case ,
-and to disable
-.IR underlining .
-.
-If it is to appear in the printed text, it must be preceded by the
-.I quote
-character
-.FONT CB _\[rs] R .
-.
-.
-.TP
-.FONT CB < CI "   less\-than   " I "Capitalize next word"
-If
-.FONT CB ".FLAGS CAPITALIZE"
-has been engaged, the
-.FONT CI less\-than
-character
-.FONT CB <
-is a special character used to capitalize the entire word it precedes.
-.
-If it is to appear in the printed text, it must be preceded by the
-.I quote
-character
-.FONT CB _< R .
-.
-.
-.TP
-.FONT CB = CR " equals\-sign " I  "hypenation disable"
-If
-.FONT CB ".FLAGS HYPHENATE"
-has been engaged, the
-.I equals
-character
-.FONT CB =
-used to disable
-.I hyphenation
-for the word it preceds.
-.
-If it is to appear in the printed text, it must be preceded by the
-.I quote
-character
-.FONT CB _= R .
-.
-.
-.TP
-.FONT CB { CR " left\-brace " I "Reverse half\-linefeed"
-If the output device type is no
-.FONT CB N R ,
-then the
-.I left
-and
-.I right braces
-are used for
-.I superscripting
-and
-.IR subscripting .
-.
-The
-.I left\-brace
-.FONT R ( CB { CR " 173 octal" R )
-produces a
-.IR "reverse half\-linefeed" .
-When combined with the
-.I right brace
-.FONT R ( CB } CR " 175 octal" R )
-scripting is created; e.g.
-.FONT CB {super}
-becomes
-.FONT CB {super} R ,
-and
-.FONT CB }sub{
-becomes
-.FONT CB }sub{ R .
-.
-.
-.TP
-.FONT CB } CR " right\-brace " I "forward half\-linefeed"
-As described above, the
-.I right brace
-.FONT R ( CB } CR " 175 octal" R )
-when coupled with the
-.I left brace
-will produce scripting.
-.
-This will only occur when a scripting output device is selected.
-.
-.
-.TP
-.FONT CB | CR " vertical\-bar " I "Engage/disengage alternate character set"
-The
-.I vertical bar
-.FONT R ( CB | R , CR " 174 octal" R )
-acts as an on/off switch.
-.
-It will alternatly transmit a
-.I shift\-out
-and a
-.I shift\-in
-character to change the selected character set; e.g.
-.FONT CB |ABC|
-becomes
-.FONT CI Ctrl\-N CB ABC CI Ctrl\-O R .
-.
-.
-.TP
-.FONT CI Ctrl\-N CR " Control-N " I "enchacement on/off;  red/black ribbon"
-If an
-.I Anderson-Jacobson output device
-is selected, a
-.FONT CI Control\-N
-.FONT R ( CI Ctrl\-N R ,
-.FONT CR "016 octal" R )
-will alternatly engage and disengage the print enchancement; e.g.
-.FONT CB NFOO CI Ctrl\-N
-becomes
-.FONT CB FOO R .
-.
-.
-.P
-If a
-.I Diablo output device
-is selected, a
-.FONT CI Control\-N
-will alternatly  select  the  red  and  black  ribbon color;  e.g.
-.FONT CB NFOO CI Ctrl\-N
-becomes
-.FONT CB FOO R .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Special Characters Overview
-.\" --------------------------------------------------------------------
-.
-.P
-Below is a list of
-.FONT CI RUNOFF R 's
-special characters.
-.
-To appear in the text, each must be preceded by the
-.CI underscore
-character (itself a special character).
-.
-.
-.TP
-.FONT CB ^
-shift character for upper case
-.
-.TP
-.FONT CB \[rs]
-shift character for lower case
-.
-.TP
-.FONT  CB <
-flag character for upper case.
-.
-Only becomes a special character if
-.FONT CB ".FLAGS CAPITALIZE"
-is engaged.
-.
-.TP
-.FONT CB #
-quoted space character
-.
-.TP
-.FONT CB =
-flag character for disabling hyphenation.
-.
-Only becomes a
-.I special character
-if
-.FONT CB ".FLAGS HYPHENATE"
-is  engaged.
-.
-.TP
-.FONT CB &
-.FONT CR underscore
-.
-.TP
-.FONT CB _
-.I quote special character
-.
-.TP
-.FONT CB {
-.I reverse half\-linefeed
-for scripting
-.
-.TP
-.FONT CB }
-.I forward half\-linefeed
-for scripting
-.
-.TP
-.FONT CB |
-switch on/off the
-.I alternate character set
-.
-.TP
-.FONT CB ^n
-switch on/off the print enchancement or switch to the red/black ribbon
-color
-.
-.
-.\" --------------------------------------------------------------------
-.SS RUNOFF Commands
-.\" --------------------------------------------------------------------
-.
-The following
-.I commands
-will be recognized if they are at the beginning of a line started with
-a period.
-.
-Any line in the source file beginning with a period is assumed to be
-one of these
-.IR commands .
-.
-If it is not, an
-.I error diagnostic
-will be typed and the line will be ignored.
-.
-Some
-.I commands
-take one or more decimal numeric arguments.
-.
-These are separated from the
-.I command
-by a
-.FONT CR space R .
-.
-More than one
-.I command
-may be entered on a single line by separating the
-.I commands
-with a
-.FONT CI semicolon
-.FONT R ` CB ; R '
-or a
-.FONT CI period
-.FONT R ` CB . R '.
-.
-.
-.P
-.I Multi\-word commands
-may appear in any form.
-.
-Thus,
-.FONT CB ".NO HEADER"
-and
-.FONT CB .NOHEADER
-are both legal.
-.
-.
-.P
-Many
-.I commands
-may be abbreviated.
-.
-Standard
-.I abbreviations
-are given below each
-.IR command .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Text Formatting Commands
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .BREAK
-.TQ
-.FONT CB .BR
-causes a
-.IR break ,
-i.e. the current line will be output with no
-.IR justification ,
-and the next word of the source text will be placed at the beginning
-of the next line.
-.
-.
-.TP
-.FONT CB .SKIP CI " n"
-.TQ
-.FONT CB .SK CI " n"
-.TQ
-.FONT CB .S CI " n"
-causes a BREAK after which
-.CI n
-is multiplied by the number of
-.I spaces
-between lines.
-.
-The result is the number of lines
-.IR skipped .
-.
-Output is advanced to the top of the next page if there is no room on
-the current page.
-.
-If the current page is empty,
-.FONT CB .SKIP
-does nothing.
-.
-.
-.TP
-.FONT CB .BLANK I " n"
-.TQ
-.FONT CB .B I " n"
-causes the current line to be output with no
-.IR justification ,
-skips
-.FONT CI n
-line spaces, and then starts output of the current source text.
-.
-.FONT CB .BLANK
-is like
-.FONT CB .SKIP R ,
-except that the
-.I space
-to be left is independent of line spacing.
-.
-If the page is empty,
-.FONT CB .BLANK
-does nothing.
-.
-.
-.TP
-.FONT CB .FIGURE I " n"
-.TQ
-.FONT CB .FG I " n"
-leaves
-.I n
-lines blank to make room for a figure or diagram.
-.
-If fewer than
-.I n
-lines remain on the current page, text continues to
-.I fill
-this page, then the page is advanced and
-.I n
-blank lines are left at the top of the next page.
-.
-.
-.TP
-.FONT CB .INDENT I " n"
-.TQ
-.FONT CB .I I " n"
-causes a
-.CI break
-and sets the next line to begin
-.I n
-spaces to the right of the left margin.
-.
-The
-.I n
-can be negative to allow beginning a line to the left of the left
-margin.
-.
-However, a line cannot begin to the left of column 0.
-.
-If
-.I n
-is not supplied, the current paragraph indent is used.
-.
-.
-.TP
-.FONT CB .PARAGRAPH I " n, v, t"
-.FONT CB .P I " n, v, t"
-causes a
-.I break
-and formats the output paragraphs.
-.
-The
-.I n
-is optional and, if present, sets the number of spaces the paragraph
-is to be indented.
-.
-The default value for
-.I n
-is
-.FONT CB 5
-.RI ( n
-can also have a negative value).
-.
-.I v
-is the vertical spacing between paragraphs.
-.
-.I v
-can range from
-.FONT CB 0
-to
-.FONT CB 5 R .
-.
-.FONT R ( CB 1
-is
-.IR "single spacing" ,
-.FONT CB 2
-is
-.IR "double spacing" ,
-etc.)
-.
-.I t
-causes an automatic
-.FONT CI ".TEST PAGE"
-(see the
-.FONT CB ".TEST PAGE"
-.IR command ).
-.
-.
-.TP
-.FONT CB .CENTER I " n" CB ; I text
-.TQ
-.FONT CB .CENTRE I " n" CB ; I text
-.TQ
-.FONT CB .C I " n" CB ; I text
-causes a
-.I break
-and centers the following text in the source file.
-.
-The centering is over column
-.FONT CB ( I n CB " + " I "left margin" CB )/2 R .
-If
-.I n
-is not given, it is assumed to be the
-.
-.IR "right margin" .
-.
-.
-.RS
-.P
-.ce
-NOTE
-.
-.P
-.FONT CB CENTER R ,
-.FONT CB "RIGHT MARGIN" R ,
-.FONT CB "LEFT MARGIN" R ,
-.FONT CB "PAGE SIZE" R ,
-and
-.FONT CB STANDARD
-take both relative and absolute values.
-.
-Relative values are expressed as
-.FONT CB + I n
-or
-.FONT CB \- I n R ,
-while absolute values of
-.I n
-are unsigned.
-.RE
-.
-.
-.TP
-.FONT CB .FOOTNOTE I " n"
-.TQ
-.FONT CB .FN I " n"
-saves
-.I n
-lines at the bottom of the current page for a
-.IR footnote .
-.
-The
-.I n
-is multiplied by the number of spaces set with the
-.FONT CB .SPACING
-command.
-.
-If insufficient room remains on the current page, space is allocated
-at the bottom of the following page.
-.
-The text of the
-.I footnote
-should begin on the line following the
-.FONT CB .FOOTNOTE
-command.
-.
-.IR Indentation ,
-.IR "case lock" ,
-.IR justify ,
-.IR margins ,
-.IR spacing ,
-and
-.I fill
-are preserved around footnotes.
-.
-However,
-.I commands
-that affect page formatting are illegal in a
-.IR footnote .
-.
-.I Tab stops
-are illegal because they are not preserved.
-.
-A footnote within a footnote is also illegal.
-.
-.
-.P
-The actual space taken by a footnote can be more or less than
-specified by
-.IR n .
-If necessary
-.FONT CR adjust
-.I n
-after examining a draft printout.
-.
-.
-.P
-The
-.I footnote
-is terminated with a line beginning with an exclamation point (the
-remainder of which is ignored).
-.
-.
-.TP
-.FONT CB .NOTE I " text"
-.TQ
-.FONT CB .NT I " text"
-starts an
-.IR "indented note" .
-.
-This command
-.I blanks
-.FONT CB 2 R ,
-reduces both
-.IR margins ,
-.I centers
-the text (if no text is given, it centers the word
-.FONT CB NOTE R ),
-and then
-.I blanks
-.FONT CB 1 R .
-.
-At this point you enter the text of the
-.IR note .
-.
-If the left margin is at
-.FONT CB 0 R ,
-the
-.I margin reduction
-is
-.FONT CB 15 R ,
-otherwise it is
-.FONT CB 5 R .
-.
-.
-.TP
-.FONT CB ".END NOTE"
-.TQ
-.FONT CB .EN
-terminates the
-.FONT CB .NOTE
-command,
-.I blanks
-.CONT CB 2 R ,
-and reverts the margins and spacing modes to their settings before the
-last
-.FONT CB .NOTE
-command.
-.
-.
-.TP
-.FONT CB .LIST I " n"
-.FONT CB .LS I " n"
-starts an indented list with
-.I n
-spacing, moves the left margin
-.FONT CB 9
-spaces to the right for the first
-.FONT CB .LIST
-command, and
-.FONT CB 4
-more spaces for each subsequent nested
-.FONT CB .LIST R .
-.
-The normal
-.I fill
-and
-.I justify modes
-remain in effect.
-.
-Therefore, you must disengage them just after the
-.FONT CB .LS
-command if you want a ragged right.
-.
-.
-.TP
-.FONT CB ".LIST ELEMENT;" I " text"
-.TQ
-.FONT CB .LE; I " text"
-starts an item in the list, used in conjunction with the
-.FONT CB LIST
-comand.
-.
-The elements are numbered sequentially and the number is given a
-negative indent so that the list lines up.
-.
-The number is followed by a
-.I period
-and two
-.I spaces
-so that the indent will be by 
-.FONT CB \-4 R .
-.
-The
-.I list elements
-are separated by the standard paragraph spacing and
-.FONT CI "TEST PAGE" R .
-.
-If you want to type the text on the same line as the command, you must
-separate the text from the command with any number of intervening
-.I spaces
-or
-.IR tabs ,
-or (optionally) one
-.IR semicolon .
-.
-.
-.TP
-.FONT CB ".END LIST"
-.TQ
-.FONT CB .ELS
-terminates the
-.FONT CB .LIST
-command and returns to settings before the last
-.FONT CB .LIST
-command.
-.
-.
-.TP
-.FONT CB .COMMENT I " text"
-.TQ
-.FONT CB .; I " text"
-causes the line to be ignored.
-.
-The text is not printed in the output file, but rather is used as a
-.I comment
-line in the source text.
-.
-.
-.\" --------------------------------------------------------------------
-.SS Page Formatting Commands
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .PAGE
-.FONT CB .PG
-causes a
-.I break
-and an
-.I advance
-to a new page.
-.
-If the current page is empty, this
-.I command
-does not
-.I advance
-the page.
-.
-Just like an
-.IR "automatic page advance" ,
-this
-.I command
-prints the
-.I title
-(if given) and
-.I page numbers
-on every page.
-.
-.
-.TP
-.FONT CB ".TEST PAGE" I " n"
-.TQ
-.FONT CB .TP I " n"
-causes a
-.I break
-followed by a
-.IR "conditional page advance" .
-.
-It skips to the next page if fewer than
-.I n
-lines are left on the page.
-.
-This capability is to ensure that the following
-.I n
-lines are all output on the same page.
-.
-This
-.I command
-has the form
-.I t
-as an optional argument to the
-.FONT CB .PARAGRAPH
-command.
-.
-.
-.TP
-.FONT CB .NUMBER I " n"
-.TQ
-.FONT CB .NM I " n"
-starts page numbering.
-.
-This is the default so there is no reason to issue this command unless
-page numbering is disengaged.
-.
-If
-.I resumption
-of page numbering is desired at a certain page, specify
-.IR n .
-.
-.
-.TP
-.FONT CB .NONUMBER
-.FONT CB .NNM
-disengages page numbering.
-.
-However, pages continue to be counted, so that the normal page number
-can appear if page numbering is re\-entered with the
-.FONT CB .NUMBER
-command.
-.
-.
-.TP
-.FONT CB .CHAPTER I " text"
-.TQ
-.FONT CB .CH I " text"
-starts a new chapter using the text as the title of the chapter.
-.
-This
-.I command
-acts as if the following
-.I command string
-were entered:
-.
-.
-.P
-.EX
-.nop ".BREAK;.PAGE;.BLANK 12;.CENTER;CHAPTER n"
-.EE
-.P
-The
-.I n
-is incremented by
-.FONT CB 1
-automatically.
-.
-After the CHAPTER
-.I n
-is typed on the page,
-.
-.
-.P
-.EX
-.nop .BLANK 2;.CENTER;text;.BLANK 3
-.EE
-.P
-occurs.
-.
-This
-.I command
-then resets the
-.IR case ,
-.IR margins ,
-.IR spacing ,
-and
-.IR "justify/fill modes" .
-.
-It also clears any
-.I subtitles
-and sets the
-.I chapter name
-as the
-.IR title .
-.
-.
-.TP
-.FONT CB ".NUMBER CHAPTER " I " n"
-supplies a number
-.I n
-to be used in a subsequent
-.FONT CB .CHAPTER
-command.
-.
-.FONT CB ".NUMBER CHAPTER"
-would be used when a
-.I chapter
-of a document occupies a source file of its own.
-.
-In such a case,
-.FONT CB ".NUMBER CHAPTER"
-would be the first command of the source file.
-.
-.
-.TP
-.FONT  CB ".HEADER LEVEL" I " n text"
-.TQ
-.FONT CB .HL I " n text"
-starts a section at the level specified and takes the following text
-as the header.
-.
-.I n
-can range from
-.FONT CB 1
-to
-.FONT CB 5 R .
-.
-The sections are incremented by
-.FONT CB 1
-automatically, and the number is output in the form
-.FONT I i CB . I j CB . I k CB . I l CB . I m R .
-If this is a chapter oriented document, the
-.I i
-is the chapter number.
-.
-Otherwise, it is the number of the
-.FONT CB ".HL 1"
-level.
-.
-This command acts as a
-.
-.P
-.EX
-.FONT CB ".BREAK;.TEST PAGE 9;.BLANK 3"
-.EE
-.
-.P
-followed by the
-.IR "section number" ,
-two
-.IR spaces ,
-and the
-.IR "section name" .
-.
-.FONT CI "HEADER LEVELS " CB 1
-and
-.FONT CB 2
-end with a
-.IR break .
-.FONT CI "HEADER LEVELS"
-.FONT CB 3 R ", " CB 4 R ,
-and
-.FONT CB 5
-end with a space\-dash\-space combination (#\-#).
-.
-.
-.TP
-.FONT CB .TITLE I " text"
-.TQ
-.FONT CB .T I " text"
-takes the remaining text as the title and outputs it on every page at
-line
-.FONT CB 0 R .
-.
-The default is no title.
-.
-If a
-.I title
-is desired, this
-.I command
-must be entered in the source file.
-.
-.
-.TP
-.FONT CB ".FIRST TITLE" I " text"
-.TQ
-.FONT CB ".FT" I " text"
-Same as
-.FONT CB .TITLE R ,
-but used to specify the title to be printed on the first page of the
-document.
-.
-This command must precede all text in the source file.
-.
-Use of the
-.FONT CB ".FIRST TITLE"
-command is the only way to print a title line on the first page of the
-document.
-.
-.
-.TP
-.FONT CB .SUBTITLE I " text"
-.TQ
-.FONT CB .SUBTTL I " text"
-.TQ
-.FONT CB .ST I " text"
-takes the remaining text as the
-.I subtitle
-and outputs it on every page.
-.
-It appears directly under the title.
-.
-The
-.I subtitle
-is not
-.IR indented ,
-but
-.I indentation
-can be achieved by typing leading spaces.
-.
-.
-.TP
-.FONT CB .INDEX I " text"
-.TQ
-.FONT CB .X I " text"
-takes the remaining text on the line as a keyword and adds it, along
-with the current
-.IR "page number" ,
-to the internal index buffer.
-.
-The command does not cause a
-.IR break .
-.
-It should appear immediately before the item to be
-.IR indexed .
-.
-A keyword may be
-.I indexed
-more than once.
-.
-.
-.TP
-.FONT CB ".DO INDEX" I " text"
-.TQ
-.FONT CB ".DX" I " text"
-forces a new page, centers the text, if given, otherwise it centers
-the word
-.FONT CI "INDEX" R .
-.
-This command prints the entire contents of the index buffer.
-.
-Entries are printed in alphabetic order and are set against the left
-margin.
-.
-Regular line spacing is used, except that a blank line is left between
-entries of different first letters.
-.
-The page number of each entry is placed on the same line as the entry
-and in the middle of the page.
-.
-Additional page numbers for multiple entries follow, separated by
-commas.
-.
-The index buffer is left empty.
-.
-.
-.TP
-.FONT CB ".PRINT INDEX"
-.TQ
-.FONT CB ".PX"
-forces a new page after which it prints the entire contents of the
-index buffer.
-.
-Entries are printed in alphabetical order and are set against the left
-margin.
-.
-Regular line spacing is used, except that a blank line is left between
-entries of different first letters.
-.
-The number of the first page on which each entry appeared is put on
-the same line as the entry, beginning at the middle of the line
-(midway betweeen the left and right margins).
-.
-Additional page numbers for multiple entries follow, separated by
-commas.
-.
-The index buffer is left empty.
-.
-.
-.P
-.FONT CB ".PRINT INDEX"
-and
-.FONT CB ".DO INDEX"
-perform the same task.
-.
-The only difference is that
-.FONT CB ".PRINT INDEX"
-does not interrupt the normal chapter and page sequencing.
-.
-.
-.TP
-.FONT CB .SUBPAGE
-executes a
-.FONT CB .PAGE
-with page numbering suspended.
-.
-The page number is unchanged, but letters are appended to the page
-number.
-.
-This permits insertion of additional pages within an existing document
-without changing the existing page numbering.
-.
-.
-.TP
-.FONT CB ".END SUBPAGE"
-disengages the
-.FONT CB .SUBPAGE
-command by executing a
-.FONT CB .PAGE
-command with page numbering resumed.
-.
-.
-.TP
-.FONT CB .APPENDIX I " text"
-.TP
-.FONT CB .AX I " text"
-starts a new appendix using the text as the title of the appendix.
-.
-This command acts as if the following command string were entered:
-.
-.RS
-.P
-.EX
-.nop ".BREAK;.PAGE;.BLANK 12;.CENTER;APPENDIX a"
-.EE
-.RE
-.P
-The a is a letter that is incremented alphabetically automatically.
-.
-After the
-.FONT CB "APPENDIX A"
-is typed on the page,
-.
-.RS
-.P
-.EX
-.nop .BLANK 2;.CENTER;text;.BLANK 3
-.EE
-.RE
-.
-.P
-occurs.
-.
-This command then resets the
-.IR case ,
-.IR margins ,
-.IR spacing ,
-and
-.IR justify/fill
-modes.
-.
-It also clears any subtitles and sets the appendix name as the title.
-.
-.
-.TP
-.FONT CB ".NUMBER APPENDIX" I " a"
-supplies a letter
-.I a
-to be used as the letter for a subsequent
-.FONT CB .APPENDIX
-command.
-.
-.
-.TP
-.FONT CB .HEADER I " arg"
-.TQ
-.FONT CB .HD I " arg"
-causes the page header
-.RI ( title ,
-.IR subtitle ,
-and
-.IR "page number" )
-to be printed.
-.
-.I arg should be
-.FONT CB UPPER
-to specify
-.I upper case characters
-for the title text,
-.FONT CB LOWER
-to specify
-.IR "lower case" ,
-or
-.FONT CB MIXED R .
-.
-The initial setting is
-.FONT CB ".HEADER UPPER" R .
-.
-.
-.TP
-.FONT CB .NOHEADER
-.TP
-.FONT CB .NHD
-causes the page header
-.RI ( title ,
-.IR subtitle ,
-and
-.IR "page number" )
-to be omitted.
-.
-The header lines are completely omitted, so that text begins at the
-top of the page with no
-.IR "top margin" .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Mode Setting Commands
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB .JUSTIFY
-.TQ
-.FONT CB .J
-causes a break and sets subsequent output lines to be justified
-(initial setting).
-.
-The
-.I command
-increases the spaces between words until the last word exactly meets
-the right margin.
-.
-.
-.TP
-.FONT CB .NOJUSTIFY
-.TQ
-.FONT CB .NJ
-causes a
-.I break
-and prevents
-.I justification
-of subsequent output lines to make a ragged right margin.
-.
-.
-.TP
-.FONT CB .FILL
-.TQ
-.FONT CB .F
-causes a break and specifies that subsequent output lines be filled
-(inital setting).
-.
-Sets the justification mode to be that specified by the last
-appearance of
-.FONT CB  .JUSTIFY
-or
-.FONT CB NOJUSTIFY R .
-.
-.FONT CB .FILL
-adds successive words from the source text until the adding of one
-more word will exceed the right margin.
-.
-It stops before putting the last word in.
-.
-(If
-.I hyphenation
-has not been disabled,
-.FONT CB RNO
-will attempt to
-.I break
-words which cause line overflow into syllables.)
-.
-.
-.TP
-.FONT CB .NOFILL
-.TP
-.FONT CB .NF
-disengages the
-.I fill
-and
-.IR "justify modes" .
-.
-This
-.I command
-is used to permit typing a table.
-.
-.
-.RS
-.
-.
-.P
-.ce
-NOTE
-.
-.P
-1. The
-.I nofill\-nojustify mode
-need be used only where there are several lines of material to be
-copied exactly.
-.
-A single line example will not require using these commands if there
-are breaks before and after.
-.
-.
-.P
-2. Normally
-.FONT CB .FILL
-and
-.FONT CB NOFILL
-are used to turn both
-.I filling
-and
-.I justification
-on and off.
-.
-It is usually desirable to do both.
-.
-A subsequent appearance of a
-.I justification command
-will override the
-.I fill command
-however.
-.
-.
-.P
-3. Because of the action of
-.FONT CB .FILL R ,
-a single occurrance of
-.FONT CB NOJUSTIFY
-will cause the remainder of the file to be
-.IR unjustified ,
-with
-.I filling
-as specified.
-.
-In order to
-.I justify
-but
-.I not fill
-(not recommended), a
-.FONT CB .JUSTIFY
-command must follow every
-.FONT CB .NOFILL
-command.
-.
-.
-.RE
-.
-.
-.TP
-.FONT CB ".UPPER CASE"
-.TQ
-.FONT CB .UC
-sets the output mode to
-.IR "upper case" .
-.
-This comand acts the same as typing two
-.CI circumflexes
-.FONT CB ^^ R .
-.
-This is the default mode.
-.
-There is no need to type this command unless the mode was previously
-altered to
-.IR "lower case" .
-.
-.
-.TP
-.FONT CB ".LOWER CASE"
-.TQ
-.FONT CB .LC
-sets the typeout mode to
-.IR "lower case" .
-This command acts the same as typing two
-.I back\-slashes
-.FONT CB \[rs]\[rs] R .
-.
-.
-.TP
-.FONT CB ".FLAGS CAPITALIZE"
-.TQ
-.FONT CB ".FL CAPITALIZE"
-enables the
-.CI less\-than
-.FONT CB <
-character to
-.I capitalize
-the entire word it precedes.
-.
-It then returns the file to the current case mode.
-.
-This
-.I special character
-is usually
-.FONT CR off
-and must be typed at the very beginning of the source text to enable
-this character.
-.
-Typing a space or another
-.FONT CI "less\-than " CB <
-returns the file to the current
-.IR "case lock" .
-.
-.
-.TP
-.FONT CB ".NO FLAGS CAPITALIZE"
-.TQ
-.FONT CB .NFC
-disengages the
-.FONT CB "FLAG CAPITALIZE"
-command (inital setting).
-.
-.
-.TP
-.FONT CB .HYPHENATION
-.TQ
-.FONT CB .HY
-engages
-.I hyphenization
-(initial setting).
-.
-.
-.TP
-.FONT CB ".NO HYPHENATION"
-.TQ
-.FONT CB .NHY
-disengages
-IR hyphenization .
-.
-.
-.TP
-.FONT CB ".FLAGS HYPHENATE"
-.TQ
-.FONT CB ".FL HYPHENATE"
-enables the
-.I equals character
-.FONT CB =
-to disengage
-.I hyphenization
-for the word it precedes.
-.
-This
-.I special character
-is initially
-.FONT CR off
-and must be typed at the beginning of the source file to enable this
-character.
-.
-The
-.FONT CI "FLAGS HYPHENATE"
-.I character
-is used to disengage
-.I hyphenization
-for words improperly
-.I hyphenated
-by the
-.IR "hyphenization algorithm" .
-.
-.
-.TP
-.FONT CB ".NO FLAGS HYPHENATE"
-.TQ
-.FONT CB .NFH
-disengages the
-.FONT CB ".FLAGS HYPHENATE"
-command (initial setting).
-.
-.
-.TP
-.FONT CB .NFL
-disengages the
-.FONT CB ".FLAGS CAPITALIZE"
-and the
-.FONT CB ".FLAGS HYPHENATE"
-commands (initial setting).
-.
-.
-.TP
-.FONT CB .PERIOD
-.TQ
-.FONT CB .PR
-enables printing of two
-.I spaces
-after every
-.I period
-.FONT CB .
-that is followed by at least one
-.I separator character
-(initial setting).
-.
-.
-.TP
-.FONT CB .NOPERIOD
-.TQ
-.FONT CB .NPR
-disengages conversion of
-.I period/separator
-to
-.IR "period/two spaces" .
-.
-.
-.TP
-.FONT CB .LITERAL
-.TQ
-,FONT CB .LIT
-disengages
-.I fill/justify
-to permit printing of text exactly as entered in source file.
-.
-.
-.TP
-.FONT CB ".END LITERAL"
-.TQ
-.FONT CB .ELI
-used after
-.FONT CB .LITERAL
-command to re\-engage
-.IR fill/justify .
-.
-.
-.\" --------------------------------------------------------------------
-.SS Parameter Setting Commands
-.\" --------------------------------------------------------------------
-.
-.TP
-.FONT CB ".LEFT MARGIN" I " n"
-.TQ
-.FONT CB .LM I " n"
-sets the left margin to
-.IR n .
-.
-The
-.I n
-must be less than the right margin but not less than
-.FONT CB 0 R .
-The initial setting is
-.FONT CB 0 R .
-If
-.I n
-is not supplied,
-.FONT CB 0
-is used.
-.
-.
-.TP
-.FONT CB ".RIGHT MARGIN" I " n"
-.TQ
-.FONT CB .RM I " n"
-sets the right margin
-.IR n .
-The
-.I n
-must be greater than the left margin.
-.
-The initial setting is
-.FONT CB 60 R .
-.
-If
-.I n
-is not supplied, the current page width (set with the
-.FONT CB ".PAGE SIZE"
-command) is used.
-.
-.
-.TP
-.FONT CB ".PAPER SIZE" I " n" CB , I m
-.TP
-.FONT CB ".PAGE SIZE" I " n" CB , I m
-.TP
-.FONT CB ".PS" I " n" CB , I m
-sets the size of the page
-.I n
-lines by
-.I m
-columns and sets the right margin to
-.IR m .
-The default setting is
-.FONT CB 58,60 R .
-.
-.
-.TP
-.FONT CB .PITCH I " n" CB , I m
-.TQ
-.FONT CB .PIT I " n" CB , I m
-sets the horizontal and vertical pitch on a supporting output device.
-.
-The horizontal pitch is
-.I n
-and is specified as characters per inch.
-.
-The value must divide evenly into
-.FONT CB 60
-for
-.FONT CI "Anderson\-Jacobson devices"
-and into
-.FONT CB 120
-for
-.FONT CI "Diablo devices" R .
-.
-The default is
-.FONT CB 12 R .
-.
-.
-.P
-The vertical pitch is
-.I m
-and is specified as lines per inch.
-.
-.I m
-must divide evenly into
-.FONT CB 48 R .
-.
-The default is the hardware setting.
-.
-.I n
-and
-.I m
-may be set independently.
-.
-.
-.TP
-.FONT CB .SPACING I " n"
-.TQ
-.FONT CB .SP I " n"
-sets the number of spaces between lines.
-.
-The
-.I n
-can range from
-.FONT CB 1
-to
-.FONT CB 5 R .
-.
-The default setting is
-.FONT CB 1 R .
-.
-.FONT CB ".SPACING 1"
-is like
-.I single spacing
-on a typewriter and
-.FONT CB ".SPACING 2"
-is like
-.IR "double spacing" .
-.FONT CB ".SPACING 2"
-puts one
-.I blank line
-between lines of text.
-.
-.
-.TP
-.FONT CB .STANDARD I " n"
-.TQ
-.FONT CB .SD I " n"
-returns all parameters, except the pitch settings, to their initial
-settings and sets
-.I n
-as the page width.
-.
-If
-.FONT CB ".STANDARD 60"
-is specified, margins are reset
-.FONT CB ".LM 0" R ,
-.FONT CB ".RM 60" R ,
-.FONT CB ".PAGE SIZE 58,60" R ,
-.FONT CB ".SPACING 1" R ,
-.FONT CB "PARAGRAPH INDENT 5" R ,
-and
-.I fill
-and
-.I justify
-are enabled.
-.
-.FONT CB ".STANDARD 70"
-sets right margin to
-.FONT CB 70
-and
-.I page size
-to
-.FONT CB 58,70 R .
-.
-.
-.TP
-.FONT CB ".TAB STOPS" I " n" CB , I n CB , I \*[Ellipsis]
-.TQ
-.FONT CB ".TS" I " n" CB , I n CB , I \*[Ellipsis]
-sets tabs.
-.
-The
-.I  n
-must be greater than
-.FONT CB 0
-and listed in ascending order.
-.
-If tabs already exist, the issuing of another
-.FONT CB ".TAB STOPS"
-command clears all previous
-.I tabs
-before setting new ones.
-.
-The
-.I default tabs
-are set at eight\-column intervals to match the
-.FONT CR Digital
-hardware standard.
-.
-These
-.I tabs
-are at columns
-.FONT CB 8 R ,
-.FONT CB 16 R ,
-.FONT CB 24 R ,
-.FONT CB 32 R ,
-.FONT CB 40 R ,
-.FONT CB 48 R ,
-.FONT CB 56 R ,
-.FONT CB 64 R ,
-.FONT CB 72 R ,
-and
-.FONT CB 80 R .
-.
-The tabs are converted to the appropriate number of non\-expandable
-spaces.
-.
-If there are no regular spaces to the left of the
-.IR tabs ,
-they will print out at the appropriate position, even if
-.I fill
-is on.
-.
-If
-.I literal
-is on, the
-.I tabs
-are not converted to
-.IR spaces ,
-but are output as
-.IR tabs .
-.
-.
-.TP
-.FONT CB .AUTOPARAGRAPH
-.TQ
-.FONT CB .AP
-causes any
-.I blank line
-or any line starting with a
-.I space
-or
-.I tab
-to be considered as the start of a new paragraph.
-.
-This command allows normally typed text to be
-.I justified
-without special commands.
-.
-It does not cause a paragraph if
-.I blank lines
-are followed by a command.
-.
-.
-.TP
-.FONT CB .NOAUTOPARAGRAPH
-.TQ
-.FONT CB .NAP
-disengages the
-.FONT CI AUTOPARAGRAPH
-mode.
-.
-.
-.\" --------------------------------------------------------------------
-.SS List of Commands (Alphabetical)
-.\" --------------------------------------------------------------------
-.
-.if t \{
-.ig endTBL
-.\}
-.
-.\" --------------------------------------------------------------------
-.\" Table using tbl for running in tty
-.\" --------------------------------------------------------------------
-.
-.nf
-.nh
-.
-.TS
-center,allbox,tab(@);
-cIw(1.5i) sw(1.5i) cIw(1.5i).
-Command or Abbreviation@Related Commands
-=
-.
-.T&
-l l l.
-\f[CB].AP\f[R]@(=\f[CB].AUTOPARAGRAPH\f[R])@
-\f[CB].APPENDIX\f[I] text \f[R]@(=\f[CB].AX\f[R])@\f[CB].NUMBER APPENDIX\f[I] a
-\f[CB].AX\f[R]@(=\f[CB].APPENDIX\f[R])@
-\f[CB].AUTOPARAGRAPH \f[R]@(=\f[CB].AP\f[R])@T{
-\f[CB].NOAUTOPARAGRAPH
-.br
-\f[R](\f[CB].NAP\f[R])
-T}
-_
-\f[CB].B\f[R]@(=\f[CB].BLANK\f[R])@
-\f[CB].BLANK \f[I]n \f[R]@(=\f[CB].B\f[R])@T{
-\f[CB].SKIP \f[I]n
-.br
-\f[R](\f[CB].S\f[R])
-T}
-\f[CB].BR\f[R]@(=\f[CB].BREAK\f[R])@
-\f[CB].BREAK@\f[R](=\f[CB].BR\f[R])
-_
-\f[CB].C\f[R]@(=\f[CB].CENTRE\f[R])@
-\f[CB].CENTER\f[R]@(=\f[CB].CENTRE\f[R])@
-\f[CB].CENTRE \f[I]n\f[CB];\f[I]text \f[R]@(=\f[CB].C\f[R])@
-\f[CB].CH\f[R]@(=\f[CB].CHAPTER\f[R])@
-\f[CB].CHAPTER \f[I]text \f[R]@(=\f[CB].CH\f[R])@\f[CB].NUMBER CHAPTER \f[I]n
-\f[CB].COMMENT \f[I]text\f[R]@@
-_
-\f[CB].DO INDEX \f[I]text \f[R]@(=\f[CB].DX\f[R])@T{
-.
-\f[CB].PRINT INDEX
-.br
-\f[R](\f[CB].PX\f[R])
-T}
-.
-\f[CB].DX\f[R]@(=\f[CB].DO INDEX\f[R])@
-_
-\f[CB].ELS\f[R]@(=\f[CB].END LIST\f[R])@
-\f[CB].EN\f[R]@(=\f[CB].END NOTE\f[R])@
-.
-\f[CB].END LIST\f[R]@(=\f[CB].ELS\f[R])@T{
-\f[CB].LIST \f[I]n
-.br
-\f[R](\f[CB].LS\f[R])
-T}
-.
-\f[CB].END LITERAL \f[R]@(=\f[CB].ELI\f[R])@T{
-\f[CB].LITERAL
-.br
-\f[R](\f[CB].LIT\f[R])
-T}
-.
-\f[CB].END NOTE\f[R]@(=\f[CB].EN\f[R])@T{
-\f[CB].NOTE \f[I]text
-.br
-\f[R](\f[CB].NT\f[R])
-T}
-.
-\f[CB].END SUBPAGE\f[R]@@\f[CB].SUBPAGE
-_
-\f[CB].F\f[R]@(=\f[CB].FILL\f[R])@
-\f[CB].FG\f[R]@(=\f[CB].FIGURE\f[R])@
-\f[CB].FIGURE n \f[R]@(=\f[CB].FG\f[R])@
-.
-\f[CB].FILL \f[R]@(=\f[CB].F\f[R])@T{
-\f[CB].NOFILL
-.br
-\f[R](\f[CB].NF\f[R])
-T}
-.
-\f[CB].FIRST TITLE \f[I]text\f[R]@(=\f[CB].FT\f[R])@\f[CB].TITLE \f[I]text
-.
-\f[CB].FLAGS CAPITALIZE\f[R]@(=\f[CB].FL CAPITALIZE\f[R])@T{
-\f[CB].NO FLAGS CAPITALIZE
-.br
-\f[R](\f[CB].NFL\f[R])
-T}
-.
-\f[CB].FLAGS HYPHENATE \f[R]@(=\f[CB].FL HYPHENATE\f[R])@T{
-\f[CB].NO FLAGS HYPHENATE
-.br
-\f[R](\f[CB].NFH\f[R])
-T}
-.
-\f[CB].FN\f[R]@(=\f[CB].FOOTNOTE\f[R])@
-\f[CB].FOOTNOTE \f[I]n\f[R]@(=\f[CB].FN\f[R])@
-\f[CB].FT\f[R]@(=\f[CB].FIRST TITLE\f[R])@
-_
-\f[CB].HD\f[R]@(=\f[CB].HEADER\f[R])@
-.
-T{
-\f[CB].HEADER \f[I]arg\f[R]
-.br
-\f[R]  [\f[I]arg\f[R]=\f[CB]UPPER\f[R], \f[CB]LOWER\f[R], or \f[CB]MIXED]\f[R]
-T}@(=\f[CB].HD\f[R])@T{
-\f[CB].NOHEADER
-.br
-\f[R](\f[CB].NHD\f[R])
-T}
-.
-\f[CB].HEADER LEVEL \f[I]n text\f[R]@(=\f[CB].HL\f[R])@
-\f[CB].HL\f[R]@(=\f[CB].HEADER LEVEL\f[R])@
-\f[CB].HY\f[R]@(=\f[CB].HYPHENATION\f[R])@
-.
-\f[CB].HYPHENATION \f[R]@(=\f[CB].HY\f[R])@T{
-\f[CB].NO HYPHENATION
-.br
-\f[R](\f[CB].NHY\f[R])
-T}
-.
-_
-\f[CB].I\f[R]@(=\f[CB].INDENT\f[R])@
-\f[CB].INDENT \f[I]n\f[R]@(=\f[CB].I\f[R])@
-\f[CB].INDEX \f[I]text \f[R]@(=\f[CB].X\f[R])@
-_
-\f[CB].J\f[R]@(=\f[CB].JUSTIFY\f[R])@
-.
-\f[CB].JUSTIFY \f[R](\f[CB].J\f[R])@@T{
-\f[CB].NOJUSTIFY
-.br
-\f[R](\f[CB].NJ\f[R])
-T}
-.
-_
-\f[CB].LC\f[R]@(=\f[CB].LOWER CASE\f[R])@
-\f[CB].LE\f[R]@(=\f[CB].LIST ELEMENT\f[R])@
-.
-\f[CB].LEFT MARGIN \f[I]n\f[R]@(=\f[CB].LM\f[R])@T{
-\f[CB].RIGHT MARGIN \f[I]n
-.br
-\f[R](\f[CB].RM\f[R])
-T}
-.
-\f[CB].LIST \f[I]n\f[R]@(=\f[CB].LS\f[R])@T{
-\f[CB].END LIST
-.br
-\f[R](\f[CB].ELS\f[R])
-T}
-.
-\f[CB].LIST ELEMENT;\f[I]text\f[R]@(=\f[CB].LE\f[R])@T{
-\f[CB].END LIST
-.br
-\f[R](\f[CB].ELS\f[R])
-T}
-.
-\f[CB].LIT\f[R]@(=\f[CB].LITERAL\f[R])@
-.
-\f[CB].LITERAL\f[R]@(=\f[CB].LIT\f[R])@T{
-\f[CB].END LITERAL
-.br
-\f[R](\f[CB].ELI\f[R])
-T}
-.
-\f[CB].LM\f[R]@(=\f[CB].LEFT MARGIN\f[R])@
-.
-\f[CB].LOWER CASE\f[R]@(=\f[CB].LC\f[R])@T{
-\f[CB].UPPER CASE
-.br
-\f[R](\f[CB].UC\f[R])
-T}
-.
-\f[CB].LS\f[R]@(=\f[CB].LIST\f[R])@
-_
-\f[CB].NAP\f[R]@(=\f[CB].NOAUTOPARAGRAPH\f[R])@
-\f[CB].NF\f[R]@(=\f[CB].NOFILL\f[R])@
-\f[CB].NFC\f[R]@(=\f[CB].NO FLAGS CAPITALIZE\f[R])@
-\f[CB].NFH\f[R]@(=\f[CB].NO FLAGS HYPHENATE\f[R])@
-.
-\f[CB].NFL\f[R]@T{
-(=\f[CB].NO FLAGS CAPITALIZE
-.br
-.ce
-\f[R] and
-.br
-\f[CB].NO FLAGS HYPHENATE\f[R])
-T}@
-.
-\f[CB].NHD\f[R]@(=\f[CB].NO HEADER\f[R])@
-\f[CB].NHY\f[R]@(=\f[CB].NO HYPHENATION\f[R])@
-\f[CB].NJ\f[R]@(=\f[CB].NO JUSTIFY\f[R])@
-\f[CB].NM\f[R]@(=\f[CB].NUMBER\f[R])@
-\f[CB].NNM\f[R]@(=\f[CB].NO NUMBER\f[R])@
-.
-\f[CB].NOAUTOPARAGRAPH\f[R]@(=\f[CB].NAP\f[R])@T{
-\f[CB].AUTOPARAGRAPH \f[R](\f[CB].AP\f[R])
-.br
-\f[CB]\ .PARAGRAPH \f[I]n,v,t \f[R](\f[CB].P\f[R])
-T}
-.
-\f[CB].NOFILL\f[R]@=(\f[CB].NF\f[R])@T{
-\f[CB].FILL
-.br
-\f[R](\f[CB].F\f[R])
-T}
-.
-\f[CB].NO FLAGS CAPITALIZE\f[R]@(=\f[CB].NFL\f[R])@T{
-\f[CB].FLAGS CAPITALIZE
-.br
-\f[R](\f[CB].FL CAPITALIZE\f[R])
-T}
-.
-\f[CB].NO FLAGS HYPHENATE\f[R]@(=\f[CB].NFH\f[R])@T{
-\f[CB].FLAGS HYPHENATE
-.br
-\f[R](\f[CB].FL HYPHENATE\f[R])
-T}
-.
-\f[CB].NOHEADER\f[R]@(=\f[CB].NHD\f[R])@T{
-\f[CB].HEADER \f[I]arg
-.br
-\f[R](\f[CB].HD\f[R])
-T}
-.
-\f[CB].NO HYPHENATION \f[R]@(=\f[CB].NHY\f[R])@T{
-\f[CB].HYPHENATION
-.br
-\f[R](\f[CB].HY\f[R])
-T}
-.
-\f[CB].NOJUSTIFY \f[R]@(=\f[CB].NJ\f[R])@T{
-\f[CB].JUSTIFY
-.br
-\f[R](\f[CB].J\f[R])
-T}
-.
-\f[CB].NONUMBER \f[R]@(=\f[CB].NNM\f[R])@T{
-\f[CB].NUMBER \f[I]n
-.br
-\f[R](\f[CB].NM\f[R])
-T}
-.
-\f[CB].NOPERIOD \f[R]@(=\f[CB].NPR\f[R])@T{
-\f[CB].PERIOD
-.br
-\f[R](\f[CB].PR\f[R])
-T}
-.
-\f[CB].NOTE text \f[R]@(=\f[CB].NT\f[R])@T{
-\f[CB].END NOTE
-.br
-\f[R](\f[CB].EN\f[R])
-T}
-.
-\f[CB].NPR\f[R]@(=\f[CB].NO PERIOD\f[R])@
-\f[CB].NT\f[R]@(=\f[CB].NOTE\f[R])@
-\f[CB].NUMBER APPENDIX \f[I]a\f[R]@@\f[CB].APPENDIX text
-\f[CB].NUMBER CHAPTER \f[I]n\f[R]@@\f[CB].CHAPTER text
-_
-\f[CB].P\f[R]@(=\f[CB].PARAGRAPH\f[R])@
-\f[CB].PAGE\f[R]@(=\f[CB].PG\f[R])@
-\f[CB].PAGE SIZE\f[R]@(=\f[CB].PAPER SIZE\f[R])@
-.
-\f[CB].PAPER SIZE \f[I]v\f[CB],\f[I]h\f[R]@T{
-(=\f[CB].PS\f[R]
-.br
-\f[CB].PAGE SIZE\f[R])
-T}@
-.
-\f[CB].PARAGRAPH \f[I]h\f[CB],\f[I]v\f[CB],\f[I]t \f[R]@(=\f[CB].P\f[R])@
-\f[CB].SKIP \f[I]n\f[R]@(=\f[CB].S\f[R])@\f[CB].BLANK \f[I]n \f[R](\f[CB].B\f[R])
-\f[CB].SP\f[R]@(=\f[CB].SPACING\f[R])@
-\f[CB].SPACING \f[I]n \f[R]@(=\f[CB].SP\f[R])@
-.
-\f[CB].PERIOD\f[R]@(=\f[CB].PR\f[R])@T{
-\f[CB].NOPERIOD
-.br
-\f[R](\f[CB].NPR\f[R])
-T}
-.
-\f[CB].PG\f[R]@(=\f[CB].PAGE\f[R])@
-\f[CB].PITCH\f[R]@(=\f[CB].PIT\f[R])@
-
-.\f[CB].PRINT INDEX \f[R]@(=\f[CB].PX\f[R])@T{
-\f[CB].DO INDEX text
-.br
-\f[R](\f[CB].DX\f[R])
-T}
-.
-\f[CB].PS\f[R]@(=\f[CB].PAPER SIZE\f[R])@
-\f[CB].PX\f[R]@(=\f[CB].PRINT INDEX\f[R])@
-_
-\f[CB].RIGHT MARGIN \f[I]n \f[R]@(=\f[CB].RM\f[R])@
-\f[CB].RM\f[R]@(=\f[CB].RIGHT MARGIN\f[R])@
-_
-\f[CB].S\f[R]@(=\f[CB].SKIP\f[R])@
-\f[CB].SD\f[R]@(=\f[CB].STANDARD\f[R])@
-\f[CB].ST\f[R]@(=\f[CB].SUBTITLE\f[R])@
-\f[CB].SUBPAGE\f[R]@@\f[CB].END SUBPAGE
-\f[CB].SUBTITLE \f[I]text \f[R]@(=\f[CB].ST\f[R])@
-_
-\f[CB].T\f[R]@(=\f[CB].TITLE\f[R])@
-\f[CB].TAB STOPS \f[I]n,n, \*[Ellipsis] ,n \f[R]@(=\f[CB].TS\f[R])@
-\f[CB].TEST PAGE \f[I]n \f[R]@(=\f[CB].TP\f[R])@
-\f[CB].TITLE text\f[R]@(=\f[CB].T\f[R])@
-\f[CB].TP\f[R]@(=\f[CB].TEST PAGE\f[R])@
-\f[CB].TS\f[R]@(=\f[CB].TAB STOPS\f[R])@
-_
-\f[CB].UC\f[R]@(=\f[CB].UPPER CASE\f[R])@
-.
-\f[CB].UPPER CASE\f[R]@(=\f[CB].UC\f[R])@T{
-\f[CB].LOWER CASE
-.br
-\f[R](\f[CB].LC\f[R])
-T}
-.
-_
-\f[CB].X\f[R]@(=\f[CB].INDEX\f[R])@
-.
-.TE
-.
-.hy
-.fi
-.
-.
-.\" End of tbl ----------------------------------------------------------------
-.
-.
-.if t \{
-.  endTBL
-.\}
-.
-.
-.\" use groff_hdtbl
-.if t \{
-.  mso hdtbl.tmac
-.  TableHDTBL
-.\}
-.
-.
-.\" --------------------------------------------------------------------
-.SH EXPERIMENTAL ADDITIONS 1965
-.\" --------------------------------------------------------------------
-.
-.
-These
-.I "control words"
-are documented in
-.FONT CI Saltzer R 's
-documentation of 1965.
-.
-It is unsure whether they were really implemented.
-.
-.
-.P
-In this documentation, all
-.I control words
-are written in
-.IR "lower case" .
-.
-The writing in
-.I upper case
-is not mentioned, the same is true for
-.IR abbreviations .
-.
-So this documentation uses only
-.IR "lower case" . 
-.
-.
-.TP
-.FONT CB .FIGURE
-This
-.I control word
-turns control over to a 
-.I figure
-.IR processor ,
-which creates in
-.I core memory
-a representation of a
-.I flow diagram
-under the control of a few special
-.IR "control words" .
-When the
-.I control word
-.FONT CB ".END FIGURE"
-is encountered, the completed picture is printed immediately on the
-page being generated if there is room on that page; otherwise the
-.I figure
-will appear at the top of the next page.
-.
-.
-.RS
-.
-.
-.P
-Text following the
-.FONT CB ".END FIGURE"
-.I control word
-will be smoothly attached to text before the
-.FONT CB .FIGURE R .
-.
-No break is generated.
-.
-(Restriction: If a
-.I figure
-is being held for placement at the top of the next page, another
-.I figure
-may not be encountered before the first one is printed.)
-.
-.
-.P
-The only
-.I control words
-which are recognized when in the
-.I \%figure processor
-are the following three:
-.FONT CB .FRAME R ,
-.FONT CB .BOX R ,
-and
-.FONT CB ".END FIGURE" R .
-.
-.
-.RE
-.
-.
-.TP
-.FONT CB .FRAME I " m n"
-This
-.I control word
-intitalizes the
-.I figure  processor
-by giving the height and width of the figure to be produced.
-.
-.I m
-is
-the height, in lines; and
-.I n
-is the width, in characters.
-.
-(Note that a 1050 types 6 lines per inch, and 10 characters per inch.)
-.
-.
-.RS
-.
-.
-.P
-Any attempt to place items in the picture which extend beyond the
-boundaries will cause an error comment to be generated.
-.
-.I \%m
-and
-.I \%n
-must both be less than 100 and their product must be smaller than
-5400.
-.
-We may now think of the
-.I figure
-to be produced as an array of
-.I m
-times
-.I n
-elements.
-.
-.
-.RE
-.
-.
-.TP
-.FONT CB .BOX I " i j"
-The text on the lines following this
-.I control word
-will be placed in the
-.I figure
-such that the first character on the first line following the
-.FONT CB .BOX
-will appear in row
-.IR i ,
-character position
--IR j .
-.
-The end of the text is indicated by a
-.FONT CB .BOX
-.I control word
-for another piece of text or the
-.FONT CB ".END FIGURE"
-.I control
-.IR word .
-.
-Temporarily, the text should not include underlined or overtyped
-characters.
-.
-.
-.TP
-.FONT CB ".END FIGURE"
-This
-.I control word
-causes control to return to the regular
-.I control processor
-of the
-.FONT CB RUNOFF
-command, for the decision to print the picture.
-.
-Note that another
-.FONT CB .FIGURE
-.I control word
-may not appear until after this
-.I figure
-has been printed.
-.
-.
-.RS
-.P
-One further
-.I control word
-has been added which is intended to facilitate bringing out revised
-editions of a memorandum.
-.
-.
-.RE
-.
-.
-.TP
-.FONT CB .FLAG
-The next line to be printed after this
-.I control word
-is encountered will have an asterisk placed two spaces to the right of
-the right margin, as illustrated.
-.
-.
-.TP
-.FONT CB .DEFINE I " symbol"
-.
-This
-.I control word
-defines  the  value  of  the  symbol
-.I symbol
-to be the number of the page currently being printed.
-.
-The symbol may be used later with the
-.FONT CB .USE
-.I control word
-to cause printing of the page number in text.
-.
-The characters in the symbol must be mappable into the six\-bit
-character set, and all symbols must be six of fewer characters.
-.
-.
-.TP
-.FONT CB .USE I " symbol"
-The value of the symbol
-.I symbol
-is inserted into the text with a single blank preceding and no blank
-following.
-.
-If the symbol has not been previously defined, its value is
-.FONT CB 0 R .
-Text may continue following a blank typed after the symbol.
-.
-.
-.RS
-.
-.
-.P
-Here is an example of the use of these
-.I control
-.IR words .
-.
-.
-.RS
-.
-.
-.P
-In one area of text:
-.
-.
-.RS
-.
-.
-.P
-We now discuss the operation of the typewriter
-.FONT CB ".DEFINE REF1"
-coordinator module, which \*[Ellipsis]
-.
-.
-.RE
-.
-.
-.P
-In a later area of text:
-.
-.
-.RS
-.
-.
-.P
-As we saw in the discussion of the typewriter coordinator on page
-.FONT CB ".USE REF1" R ,
-the rest of \*[Ellipsis]
-.
-.
-.RE
-.
-.
-.P
-if the first area of text were on page 14, the later line would read:
-.
-.
-.RS
-.
-.
-.P
-As we saw in the discussion of the typewriter coordinator on page 14,
-the rest of \*[Ellipsis]
-.
-.
-.RE
-.RE
-.RE
--
-.
-.\" --------------------------------------------------------------------
-.SS Further Study of Experimental Additions
-.\" --------------------------------------------------------------------
-.
-A number of suggestions have been made for extending the
-.I control word
-language of
-.FONT CI RUNOFF R ,
-and its capabilities.
-.
-These are listed here, primarily to elicit comment and discussion,
-both on the language which describes these operations and the less
-important problem of their implementation.
--
-.
-.TP
-1.
-.
-Word division.
-.
-This is a whole are of study in itself.
-.
-.
-.TP
-2.
-.
-Automatic  footnote  insertion.
-.
-This was handled somewhat awkwardly in the
-.FONT CB DITTO
-.IR command ,
-although the basic approach was probably reasonable.
-.
-.
-.TP
-3.
-.
-Automatic page references, perhaps via some symbolic reference scheme.
-.
-This would enable the page number in "as was described on page 32" to
-be inserted by the program.
-.
-The analogy with an assembly program should be hotly pursued for
-ideas.
-.
-.
-.TP
-4.
-.
-Special provision for printing facing pages.
-.
-This would require alternate running heads, placing page numbers
-alternately at right and left, and matching line counts on facing
-pages.
-.
-.
-.TP
-5.
-.
-Improved page\-division rules, to prevent the last line of a paragraph
-appearing alone at the top of a page, for example.
-.
-At present, copy must be run off to check by hand that awkward page
-divisions have not been made.
-.
-.
-.TP
-6.
-.
-Automatic generation of page numbers for a table of contents.
-.
-Again, the analogy of an assembly program symbol table appears
-fruitful.
-.
-.
-.TP
-7.
-.
-Automatic generations of an index.
-.
-The problem here is obtaining too many references to a given word,
-many irrelevant.
-.
-.
-.TP
-8.
-.
-Arrangement of tabulated data.
-.
-This problem may have already been partly approached with the
-above\-described figure generator, or the facilities already available
-in
-.IR RUNOFF ,
-but automatic setup of column widths and positions would be desirable.
-.
-One could include in this category the ability to call on other
-programs to computer numbers to place in tables, although this is
-going pretty far afield.
-.
-.
-.TP
-9.
-.
-Placing figures in a
-.I "cut"
-or
-.IR inset .
-.
-The control language is the most difficult problem here.
-.
-.
-.TP
-10.
-.
-Equation typing and  numbering.
-.
-Again, the control language appears formidable.
-.
-.
-.\" --------------------------------------------------------------------
-.SH MANUSCRIPT CONVENTIONS
-.\" --------------------------------------------------------------------
-.
-Initially,
-.FONT CI RUNOFF
-is set to
-.I FILL
-mode, such as by using
-.FONT CB .FILL R .
-.
-The filling is identical to
-.FONT CI groff R 's
-filling mode:
-.
-Text lines will normally be adjuted by inserting extra spaces in
-mid\-line so that the end of the line is on the right margin.
-.
-.
-.\" --------------------------------------------------------------------
-.SH AVAILABLE RUNOFF FILES
-.\" --------------------------------------------------------------------
-.
-You can still find text files in the
-.FONT CI RUNOFF
-language.
-.
-.
-.P
-In the
-.nh
-.UR http://\:www.columbia.edu/\:kermit/\:pdp10.html
-Kermit website
-.UE
-you find 3 files in
-.FONT CI RUNOFF
-language maybe of the
-.FONT CR Multics
-era or later:
-.
-.Topic
-.UR ftp://\:kermit.columbia.edu/\:kermit/\:d/\:k10133.rno
-.FONT CR k10133.rno
-.UE
-.
-.Topic
-.UR ftp://\:kermit.columbia.edu/\:kermit/\:d/\:k10mit.rnh
-.FONT CR k10mit.rnh
-.UE
-.
-.Topic
-.UR ftp://\:kermit.columbia.edu/\:kermit/\:d/\:k10v3.rno
-.FONT CR k10v3.rno
-.UE
-.hy
-.
-.
-.P
-At
-.nh
-.UR http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:pubs.html
-.FONT CR Saltzer R 's
-publication website
-.UE
-you find files in
-.FONT CI RUNOFF
-of the
-.FONT CR Multics
-era.
-.hy
-.
-Search there for
-.nh
-.FONT CR runoff
-and you will find the following 5 files:
-.
-.Topic
-.UR http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:whyring/\:whyring.run
-.FONT CR whyring.run
-.UE
-.
-.Topic
-.UR http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:starring/\:starring.run
-.FONT CR starring.run
-.UE
-.
-.Topic
-.UR http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:tmring.run
-.FONT CR tmring.run
-.UE
-.
-.Topic
-.UR http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:florence.run
-.FONT CR "RFC1498 florence.run"
-.UE
-.
-.Topic
-.UR http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:sourcerouting/\:zurich.run
-.FONT CR zurich.run
-.UE
-.hy
-.
-.
-.P
-Most
-.nh
-.FONT CI RUNOFF
-files are found in the
-.UR http://\:pdp-10.trailing-edge.com/\:cgi-bin/
-.FONT CR "DEC PDP\-10 archive"
-.UE .
-.
-Many files are very old as they are written in
-.I upper case
-only:
-.
-.Topic
-.UR http://\:pdp-10.trailing-edge.com/\:cgi-bin/\:searchbyname?name=*.rno
-normal documents
-.FONT CB *.rno
-in
-.FONT CI RUNOFF
-.UE
-.
-.Topic
-.UR http://\:pdp-10.trailing-edge.com/\:cgi-bin/\:searchbyname?name=*.rnh
-.FONT CB *.rnh
-help files in
-.FONT CI RUNOFF
-.UE
-.
-.Topic
-.UR http://\:pdp-10.trailing-edge.com/\:cgi-bin/\:searchbyname?name=runoff.*
-.FONT CB runoff.*
-documents about
-.FONT CI RUNOFF
-.UE
-.hy
-.
-.
-.\" --------------------------------------------------------------------
-.SH "SEE ALSO"
-.\" --------------------------------------------------------------------
-.
-.
-.PP
-.\" BR RUNOFF (@MAN1EXT@),
-.BR groff (@MAN1EXT@),
-.BR groff (@MAN7EXT@),
-.BR roff (@MAN7EXT@),
-.BR groff_filenames (@MAN7EXT@)
-.
-.
-.TP
-.FONT R "1964 " CR "Jerome H. Saltzer" R :
-.nh
-.FONT CI "Jerome H. Saltzer \[em] TYPSET and RUNOFF, Memorandum editor and \
-type\-out commands"
-.hy
-available at
-.UR \%http://\:mit.edu/\:Saltzer/\:www/\:publications/\:CC\-244.html
-.UE
-.
-.
-.TP
-.FONT R "1965 " CR "Jerome H. Saltzer" R :
-.nh
-.FONT CI "Jerome H. Saltzer \(em Experimental Additions to the RUNOFF Command"
-available at
-.UR http://\:web.mit.edu/\:afs/\:athena.mit.edu/\:user/\:other/\
-\:a/\:Saltzer/\:www/\:publications/\:PSN\-40.html
-.UE
-.hy
-.
-.
-.TP
-.FONT R "1966 " CR "Jerome H. Saltzer" R :
-.nh
-.FONT CI "Jerome H. Saltzer \[em] Manuscript Typing and Editing"
-.hy
-which is available in the internet at
-.UR http://\:mit.edu/\:Saltzer/\:www/\:publications/\:AH.9.01.html
-.I MIT html
-.UE
-or
-.UR \%http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:ctss\/\:AH.9.01.html
-.I CTSS html
-.UE
-or
-.UR \%http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:ctss/\:AH.9.01.pdf
-.I CTSS pdf
-.UE .
-.
-.
-.TP
-.FONT R "1973 " CR "Larry Barnes" R :
-.FONT CI "Larry Barnes \[em] RUNOFF: A Program for the Preparation of Documents"
-available as
-.UR http://\:www.textfiles.com/\:bitsavers/\:pdf/\:sds/\:9xx/\:940/\
-\:ucbProjectGenie/\:mcjones/\:R\-37_RUNOFF.pdf
-.I pdf
-.UE .
-.
-.
-.TP
-.FONT R "1974 " CR "DEC RSTS" R :
-.FONT CI "RUNOFF User's Guide" R : CR " v8.0-v4-d-rsts_e_runoff_users_guide.pdf"
-at
-.UR http://elvira.stacken.kth.se/rstsdoc/rsts-doc-v80/v8.0-v4-d-rsts_e_runoff_users_guide.pdf
-.I DEC RSTS
-.UE .
-.
-.
-.TP
-.FONT R "1981 " CR PDP\-11 R :
-This is the latest documentation on
-.FONT CI RUNOFF
-available as
-.UR http://\:malarky.udel.edu/\:~dmills/\:data/\:du0/\:RUNOFF.DOC
-text file.
-.UE .
-.
-More exactly, this
-.FONT CB .DOC
-file is an output file produced by the
-.FONT CB RUNOFF
-program a long time ago.
-.
-This extension doesn't work on actual systems who expect a Microsoft
-office file.
-.
-You have to rename this file by appending the
-.FONT CB .txt
-extension.
-.
-Then the file can be viewed by
-.FONT CB more
-or
-.FONT CB less R .
-.
-.
-.P
-.nh
-.UR http://\:www.cozx.com/\:~dpitts/\:ibm7090.html 
-Emulator for
-.FONT CR "IBM 7090 CTSS"
-.UE .
-.hy
-.
-.
-.P
-The home page of
-.FONT CI "Jerome H. Saltzer"
-is
-.UR http://\:web.mit.edu/\:Saltzer/
-.UE .
-.
-.
-.SH "AUTHORS"
-.\" --------------------------------------------------------------------
-.
-.authors
-.
-.
-.\" --------------------------------------------------------------------
-.SH "COPYING"
-.\" --------------------------------------------------------------------
-.
-.copying
-.
-.
-.\" --------------------------------------------------------------------
-.\" Emacs settings
-.\" --------------------------------------------------------------------
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" End:
-
diff --git a/contrib/RUNOFF/ChangeLog b/contrib/groff_filenames/ChangeLog
similarity index 84%
rename from contrib/RUNOFF/ChangeLog
rename to contrib/groff_filenames/ChangeLog
index ad2564a..50b0514 100644
--- a/contrib/RUNOFF/ChangeLog
+++ b/contrib/groff_filenames/ChangeLog
@@ -1,3 +1,12 @@
+2014-01-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* runoff.man: remove this file
+
+	* groff/contrib/RUNOFF: rename this directory to
+	`groff/contrib/groff_filenames'
+
+	* Makefile.sub: change this file correspondingly
+
 2013-07-31  Bernd Warken  <groff-bernd.warken-72@web.de>
 
 	Fix RUNOFF
diff --git a/contrib/RUNOFF/Makefile.sub b/contrib/groff_filenames/Makefile.sub
similarity index 90%
rename from contrib/RUNOFF/Makefile.sub
rename to contrib/groff_filenames/Makefile.sub
index 1346733..5f2a3c1 100644
--- a/contrib/RUNOFF/Makefile.sub
+++ b/contrib/groff_filenames/Makefile.sub
@@ -2,18 +2,18 @@
 
 # File position: <groff-source>/contrib/RUNOFF/Makefile.sub
 
-# Copyright (C) 2013
+# Copyright (C) 2013, 2014
 #   Free Software Foundation, Inc.
 #
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
-# Last update: 6 May 2013
+# Last update: 5 Jan 2014
 
 # This file is part of `RUNOFF' which is part of `groff'.
 
 # `groff' is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
+# the Free Software Foundation, either version 2 of the License, or
 # (at your option) any later version.
 
 # `groff' is distributed in the hope that it will be useful, but
@@ -27,7 +27,6 @@
 ########################################################################
 
 MAN7=\
-  runoff.n \
   groff_filenames.n
 
 MOSTLYCLEANADD=$(MAN7)
diff --git a/contrib/RUNOFF/groff_filenames.man b/contrib/groff_filenames/groff_filenames.man
similarity index 75%
rename from contrib/RUNOFF/groff_filenames.man
rename to contrib/groff_filenames/groff_filenames.man
index 7e0927d..940acd2 100644
--- a/contrib/RUNOFF/groff_filenames.man
+++ b/contrib/groff_filenames/groff_filenames.man
@@ -16,7 +16,7 @@ This file was written by Bernd Warken
 .
 .
 .de copying
-Copyright \(co 2013
+Copyright \(co 2013, 2014
 .RS
 .ft CI
 Free Software Foundation, Inc.
@@ -25,7 +25,7 @@ Free Software Foundation, Inc.
 .
 .
 .P
-Last update: 5 May 2013
+Last update: 5 Jan 2014
 .
 .
 .P
@@ -45,7 +45,7 @@ as published by the
 .ft CI
 Free Software Foundation (FSF)\\fR,
 .hy
-either version 3 of the License, or (at your option) any later version.
+either version 2 of the License, or (at your option) any later version.
 .
 .P
 You should have received a copy of the
@@ -120,12 +120,8 @@ You can also visit
 .\" --------------------------------------------------------------------
 .
 Since the evolution of
-.FONT CI RUNOFF
-in the 1960s and
 .FONT CI roff
 in the 1970s, a whole bunch of filename extensions for
-.FONT CI RUNOFF
-and
 .FONT CI roff
 files were used.
 .
@@ -150,211 +146,6 @@ We will now write a
 .
 .
 .\" --------------------------------------------------------------------
-.SH HISTORICAL RUNOFF LANGUAGE
-.\" --------------------------------------------------------------------
-.
-The first text language that used the
-.FONT CB .COMMAND
-structure for defining commands is said to be the
-.FONT CI MEMO
-language with programs
-.FONT CB MODIFY
-and
-.FONT CB DITTO R .
-.
-It was used at
-.FONT CR MIT
-under the operating system
-.FONT CR CTSS
-in the years 1960\-63.
-.
-But there is no open documentation for this old text system, but it
-seems that there is 1 book about it in the non-public library at
-.FONT CB MIT R .
-.
-.
-.P
-The letter
-.FONT CB m
-taken from
-.FONT CI MEMO R / MODIFY
-is still active as the option
-.FONT CB -m
-for declaring a macro package in
-.FONT CB troff R / CB nroff R .
-.
-.
-.P
-The first documented
-.FONT CB .COMMAND
-text language was
-.FONT CI RUNOFF R ,
-see
-.BR runoff (@MAN7EXT@).
-.
-.
-.\" --------------------------------------------------------------------
-.SS RUNOFF Files
-.\" --------------------------------------------------------------------
-.
-All available
-.FONT CI RUNOFF
-files are now kept in the internet at an archive on
-.FONT CI github R .
-.
-Use the command-line call
-.RS
-.EX
-.FONT CR "$ " CB "git clone git@github.com:RUNOFF/RUNOFF.git"
-.EE
-.RE
-for getting this archive (without the leading dollar).
-.
-.
-.TP
-.FONT I <name> CB .RUNOFF
-.TQ
-.FONT I <name> CB .runoff
-were the oldest naming for files in the original
-.FONT CI RUNOFF
-format of the 1960s at
-.FONT CR "IBM 7090"
-and
-.FONT CR 7094
-with the operating system
-.FONT CR CTSS R .
-.
-.
-.TP
-.FONT I <name> CB .RUN
-.TQ
-.FONT I <name> CB .run
-This abbreviation was used for
-.FONT CI RUNOFF
-files on the
-.FONT CR CTSS
-and
-.FONT CR Multics
-operating system in the 1960s and later on.
-.
-.
-.TP
-.FONT I <name> CB .RNO
-.TQ
-.FONT I <name> CB .rno
-was used for normal
-.FONT CI RUNOFF
-text files, mostly on the
-.FONT CR "PDP10\-10 archive" R .
-.
-.
-.TP
-.FONT I <name> CB .RNH
-.TQ
-.FONT I <name> CB .rnh
-was used for help files written in the
-.FONT CI RUNOFF
-language on the
-.FONT CR "PDP10\-10 archive" R .
-.
-.
-.P
-.FONT CI RUNOFF
-files with the extensions
-.FONT CB .rnh R ,
-.FONT CB .rno R ,
-and
-.FONT CB .run
-are still available in the internet at several sites, mostly at the
-.FONT CR "DEC PDP\-10 archive" R .
-.
-See
-.nh
-.UR http://\:pdp\-10.trailing\-edge.com/\:cgi-bin/\:searchbyname?name=*.rnh
-RNH
-.UE ,
-.UR http://\:pdp\-10.trailing\-edge.com/\:cgi-bin/\:searchbyname?name=*.rno
-RNO
-.UE ,
-and
-.UR http://\:pdp\-10.trailing\-edge.com/\:cgi-bin/\:searchbyname?name=*.run
-RUN
-.UE  .
-.hy
-.
-.
-.\" --------------------------------------------------------------------
-.SS Processed RUNOFF Text Files
-.\" --------------------------------------------------------------------
-.
-Files written in the
-.FONT CI RUNOFF
-language were processed by the program
-.FONT CB RUNOFF R .
-.
-Only text files were produced by this step, because graphics was not
-available in the 1960s.
-.
-Today we would use the file name extension
-.FONT CI * CB .txt R .
-.
-That was not done in these early times.
-.
-Instead the following extensions were taken:
-.
-.
-.TP
-.FONT I <name> CB .DOC
-.TQ
-.FONT I <name> CB .doc
-Very often this naming was used for the output of the
-.FONT CB RUNOFF
-program.
-.
-It contained
-.I filled
-and
-.I hyphenated
-text, suitable for tty mode.
-.
-The extension
-.FONT CB .doc
-was later on taken by
-.FONT CR Microsoft
-for their
-.IR "office files" .
-.
-.
-.TP
-.FONT I <name> CB .MEM
-.TP
-.FONT I <name> CB .mem
-This often used extension was taken for
-.FONT CI RUNOFF
-files to refer to the ancient
-.FONT CI MEMO
-language.
-.
-.
-.TP
-.FONT I <name> CB .HLP
-.TQ
-.FONT I <name> CB .hlp
-The formatting of
-.FONT CI * CB .rnh
-files (help files) was stored under this extension.
-.
-.
-.P
-This ends the description of
-.FONT CI RUNOFF .R .
-.
-All following parts of this document refer to the
-.FONT CI roff
-language and the used file name extensions thereof.
-.
-.
-.\" --------------------------------------------------------------------
 .SH COMPRESSION OF ROFF FILES
 .\" --------------------------------------------------------------------
 .
@@ -891,7 +682,6 @@ system
 .
 .TP
 History and future
-.BR runoff (@MAN7EXT@),
 .BR roff (@MAN7EXT@),
 .BR man\-pages (@MAN7EXT@),
 .BR groff_diff (@MAN7EXT@),


hooks/post-receive
-- 
GNU troff


From MAILER-DAEMON Sun Jan 05 08:05:25 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1VznOO-0008KU-VC
	for mharc-groff-commit@gnu.org; Sun, 05 Jan 2014 08:05:24 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:42998)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VznOM-0008KO-Sh
	for groff-commit@gnu.org; Sun, 05 Jan 2014 08:05:24 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VznOL-0003jE-Es
	for groff-commit@gnu.org; Sun, 05 Jan 2014 08:05:22 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:58487)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VznOL-0003j8-B9
	for groff-commit@gnu.org; Sun, 05 Jan 2014 08:05:21 -0500
Received: from bwarken by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VznOK-0004zC-L1
	for groff-commit@gnu.org; Sun, 05 Jan 2014 13:05:20 +0000
Date: Sun, 05 Jan 2014 13:05:20 +0000
Message-Id: <E1VznOK-0004zC-L1@vcs.savannah.gnu.org>
From: "Bernd Warken" <groff-bernd.warken-72@web.de>
To: groff-commit@gnu.org
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: 6b731a6d6af7ccb12393f80fec13c25ae424cf8c
X-Git-Newrev: dcdf54071d1369e724cffe2e2cfbf0461a3611d1
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
Subject: [Groff-commit] GNU troff branch, master,
	updated. dcdf54071d1369e724cffe2e2cfbf0461a3611d1
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 05 Jan 2014 13:05:24 -0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU troff".

http://git.sv.gnu.org/gitweb/?p=groff.git;a=commitdiff;h=dcdf54071d1369e724cffe2e2cfbf0461a3611d1

The branch, master has been updated
       via  dcdf54071d1369e724cffe2e2cfbf0461a3611d1 (commit)
      from  6b731a6d6af7ccb12393f80fec13c25ae424cf8c (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit dcdf54071d1369e724cffe2e2cfbf0461a3611d1
Author: Bernd Warken <groff-bernd.warken-72@web.de>
Date:   Sun Jan 5 14:04:14 2014 +0100

    In tmac/an-ext.tmac at .FONT change variable name.

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog        |    5 +++++
 tmac/an-ext.tmac |   14 +++++++-------
 2 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 05f74ab..bc5cd83 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2013-12-23  Bernd Warken  <groff-bernd.warken-72@web.de>
 
+	* groff/tmac/an-ext.tmac: in .FONT change variable name `result'
+	to `an_ext_FONT_result'.
+
+2013-12-23  Bernd Warken  <groff-bernd.warken-72@web.de>
+
 	* groff/tmac/an-ext.tmac: add new request .FONT for using
 	different font names on a single line.
 
diff --git a/tmac/an-ext.tmac b/tmac/an-ext.tmac
index 30f8c62..8ff6361 100644
--- a/tmac/an-ext.tmac
+++ b/tmac/an-ext.tmac
@@ -3,9 +3,9 @@
 .\" Written by Eric S. Raymond <esr@thyrsus.com>
 .\"            Werner Lemberg <wl@gnu.org>
 .\"
-.\" Version 2012-Mar-05
+.\" Version 2014-Jan-05
 .\"
-.\" Copyright (C) 2007, 2009, 2012 Free Software Foundation, Inc.
+.\" Copyright (C) 2007, 2009, 2012, 2014 Free Software Foundation, Inc.
 .\" You may freely use, modify and/or distribute this file.
 .\"
 .\"
@@ -188,15 +188,15 @@
 .       nop \&\f[P]\&
 .       return
 .  \}
-.  ds result \&
+.  ds an_ext_FONT_result \&
 .  while (\\n[.$] >= 2) \{\
-.       as result \,\f[\\$1]\\$2
-.       if !"\\$1"P" .as result \f[P]
+.       as an_ext_FONT_result \,\f[\\$1]\\$2
+.       if !"\\$1"P" .as an_ext_FONT_result \f[P]
 .       shift 2
 .  \}
-.  if (\\n[.$] = 1) .as result \,\f[\\$1]
+.  if (\\n[.$] = 1) .as an_ext_FONT_result \,\f[\\$1]
 .  nh
-.  nop \\*[result]\&
+.  nop \\*[an_ext_FONT_result]\&
 .  hy
 ..
 .


hooks/post-receive
-- 
GNU troff


From MAILER-DAEMON Sun Jan 05 08:11:07 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1VznTv-0000hj-Oi
	for mharc-groff-commit@gnu.org; Sun, 05 Jan 2014 08:11:07 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:43668)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VznTo-0000hX-2b
	for groff-commit@gnu.org; Sun, 05 Jan 2014 08:11:07 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VznTg-00050K-Fr
	for groff-commit@gnu.org; Sun, 05 Jan 2014 08:11:00 -0500
Received: from mout.web.de ([212.227.17.11]:51661)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <groff-bernd.warken-72@web.de>) id 1VznTg-000505-59
	for groff-commit@gnu.org; Sun, 05 Jan 2014 08:10:52 -0500
Received: from 3capp-webde-bs26.server.lan ([172.19.170.26]) by
	mriweb.server.lan (mriweb002) with ESMTP (Nemesis) id
	0LaovG-1VXMUF1CZ6-00kQu8 for <groff-commit@gnu.org>; Sun, 05 Jan 2014
	14:10:51 +0100
Received: from [188.97.255.250] by 3capp-webde-bs26.server.lan with HTTP;
	Sun Jan 05 14:10:51 CET 2014
MIME-Version: 1.0
Message-ID: <trinity-9b90f7e2-76a5-4c21-ba39-62f35bba3dd9-1388927451152@3capp-webde-bs26>
From: "Bernd Warken" <groff-bernd.warken-72@web.de>
To: "groff commit Mailingliste" <groff-commit@gnu.org>
Content-Type: text/plain; charset=UTF-8
Date: Sun, 5 Jan 2014 14:10:51 +0100 (CET)
Importance: normal
Sensitivity: Normal
X-Priority: 3
X-Provags-ID: V03:K0:pAXXxHKQZLMX8yw9ufwNiMsqmtlyTNvCoO81wOVegEW
	l2d8Zo25BbvW4dx8dRu1t16U0+BaEdNr3eD9WR6Kw2gVye3p4K
	ymcMvyCDYr1Xor+5wi30UsZlPoQnWcDO2hIoHsvIJY36EF/6pj
	rJdhrqvhq81XFBVfTdx6XPy+/mbj0hjYTU5dwcbC/+ytKTc2u7
	nJf5Hxf4CvzdyTk6BtEu7j71IMNgR2F4s3VsOrraMjN1j2xt4y
	C1cA36jv3EtAviF84p81IVWjkOVQOHBfF9z61CRB8n3gIcKmid
	+86gWtXEwen9RScHS30wkv8szOo
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic]
X-Received-From: 212.227.17.11
Subject: [Groff-commit] man pages in tmac
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 05 Jan 2014 13:11:07 -0000

In groff/tmac there are some man pages.  They are on he wrong
place.  We should move them to groff/man, where they belong.

I could do that tomorrow.

Greetings

Bernd Warken


From MAILER-DAEMON Sun Jan 05 15:25:03 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1VzuFr-0006fU-Rv
	for mharc-groff-commit@gnu.org; Sun, 05 Jan 2014 15:25:03 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54198)
	by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1VzuFn-0006eF-Ls
	for groff-commit@gnu.org; Sun, 05 Jan 2014 15:25:02 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <wl@gnu.org>) id 1VzuFk-0007MP-W9
	for groff-commit@gnu.org; Sun, 05 Jan 2014 15:24:59 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:35736)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1VzuFk-0007MI-RC
	for groff-commit@gnu.org; Sun, 05 Jan 2014 15:24:56 -0500
Received: from wl by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <wl@gnu.org>) id 1VzuFj-0002nW-UY
	for groff-commit@gnu.org; Sun, 05 Jan 2014 20:24:56 +0000
Date: Sun, 05 Jan 2014 20:24:56 +0000
Message-Id: <E1VzuFj-0002nW-UY@vcs.savannah.gnu.org>
From: "Werner Lemberg" <wl@gnu.org>
To: groff-commit@gnu.org
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: dcdf54071d1369e724cffe2e2cfbf0461a3611d1
X-Git-Newrev: f64b964b306322b7f02e07d4be58a6adbb0a0ecd
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
Subject: [Groff-commit] GNU troff branch, master,
	updated. f64b964b306322b7f02e07d4be58a6adbb0a0ecd
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 05 Jan 2014 20:25:02 -0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU troff".

http://git.sv.gnu.org/gitweb/?p=groff.git;a=commitdiff;h=f64b964b306322b7f02e07d4be58a6adbb0a0ecd

The branch, master has been updated
       via  f64b964b306322b7f02e07d4be58a6adbb0a0ecd (commit)
       via  036d485327976f5c0e40064dc7e27372ac52863f (commit)
      from  dcdf54071d1369e724cffe2e2cfbf0461a3611d1 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit f64b964b306322b7f02e07d4be58a6adbb0a0ecd
Author: Werner Lemberg <wl@gnu.org>
Date:   Sun Jan 5 21:24:09 2014 +0100

    * groff/tmac/groff_man.man: Minor typos, formatting, reordering.

commit 036d485327976f5c0e40064dc7e27372ac52863f
Author: Werner Lemberg <wl@gnu.org>
Date:   Sun Jan 5 20:35:33 2014 +0100

    Revert recent changes to `an-ext.tmac' and `groff_man.man'.
    
    * groff/tmac/an-ext.tmac (.FONT): Remove.  This doesn't belong into
    this file.
    
    * groff/tmac/groff_man.man: Reset to state previous to 2014-01-04.
    Useful changes will be re-committed in smaller, logical chunks.

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog          |   23 ++++++-
 tmac/an-ext.tmac   |   24 +-------
 tmac/groff_man.man |  173 +++++++++++++++++++++++++++++-----------------------
 3 files changed, 117 insertions(+), 103 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index bc5cd83..af6efd8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,16 +1,31 @@
-2013-12-23  Bernd Warken  <groff-bernd.warken-72@web.de>
+2014-01-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+	    Werner LEMBERG  <wl@gnu.org>
+
+	* groff/tmac/groff_man.man: Minor typos, formatting, reordering.
+
+2014-01-05  Werner LEMBERG  <wl@gnu.org>
+
+	Revert recent changes to `an-ext.tmac' and `groff_man.man'.
+
+	* groff/tmac/an-ext.tmac (.FONT): Remove.  This doesn't belong into
+	this file.
+
+	* groff/tmac/groff_man.man: Reset to state previous to 2014-01-04. 
+	Useful changes will be re-committed in smaller, logical chunks.
+
+2014-01-05  Bernd Warken  <groff-bernd.warken-72@web.de>
 
 	* groff/tmac/an-ext.tmac: in .FONT change variable name `result'
 	to `an_ext_FONT_result'.
 
-2013-12-23  Bernd Warken  <groff-bernd.warken-72@web.de>
+2014-01-04  Bernd Warken  <groff-bernd.warken-72@web.de>
 
 	* groff/tmac/an-ext.tmac: add new request .FONT for using
 	different font names on a single line.
 
 	* groff/tmac/groff_man.man: put under GPL2, reordered and enhanced.
 
-2013-01-02  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2014-01-02  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
 	* src/devices/gropdf/gropdf.pl: gropdf use to fail when handling
 	output from preconv, now works.
@@ -1519,7 +1534,7 @@ Version 1.22 released
 
 	* doc/webpage.ms: Fix rendering of title image.
 
-Copyright 2011-2013
+Copyright 2011-2014
   Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
diff --git a/tmac/an-ext.tmac b/tmac/an-ext.tmac
index 8ff6361..3816025 100644
--- a/tmac/an-ext.tmac
+++ b/tmac/an-ext.tmac
@@ -3,9 +3,9 @@
 .\" Written by Eric S. Raymond <esr@thyrsus.com>
 .\"            Werner Lemberg <wl@gnu.org>
 .\"
-.\" Version 2014-Jan-05
+.\" Version 2012-Mar-05
 .\"
-.\" Copyright (C) 2007, 2009, 2012, 2014 Free Software Foundation, Inc.
+.\" Copyright (C) 2007, 2009, 2012 Free Software Foundation, Inc.
 .\" You may freely use, modify and/or distribute this file.
 .\"
 .\"
@@ -181,26 +181,6 @@
 ..
 .
 .
-.\" .FONT (<font name> <text> [<font name> <text> ...])
-.\" Print in different fonts, e.g. using the font names R, I, B, CR, CI, CB
-.de FONT
-.  if (\\n[.$] = 0) \{\
-.       nop \&\f[P]\&
-.       return
-.  \}
-.  ds an_ext_FONT_result \&
-.  while (\\n[.$] >= 2) \{\
-.       as an_ext_FONT_result \,\f[\\$1]\\$2
-.       if !"\\$1"P" .as an_ext_FONT_result \f[P]
-.       shift 2
-.  \}
-.  if (\\n[.$] = 1) .as an_ext_FONT_result \,\f[\\$1]
-.  nh
-.  nop \\*[an_ext_FONT_result]\&
-.  hy
-..
-.
-.
 .\" Start example.
 .de EX
 .  nr mE \\n(.f
diff --git a/tmac/groff_man.man b/tmac/groff_man.man
index b21e675..84e5bca 100644
--- a/tmac/groff_man.man
+++ b/tmac/groff_man.man
@@ -1,25 +1,21 @@
 .ig
 Copyright (C) 1999-2005, 2007-2009, 2011, 2014
-  Free Software Foundation, Inc.
+Free Software Foundation, Inc.
 
-Last Update: 4 Jan 2014
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
 
-This file is part of `GNU groff'.
+Permission is granted to copy and distribute modified versions of this
+manual under the conditions for verbatim copying, provided that the
+entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
 
-  `GNU groff' is free software: you can redistribute it and/or modify it
-under the terms of the `GNU General Public License' as published by the
-`Free Software Foundation', either version 2 of the License, or (at your
-option) any later version.
-
-  `GNU groff' is distributed in the hope that it will be useful, but
-WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the `GNU
-General Public License' for more details.
-
-  You should have received a copy of the 'GNU General Public License`
-along with `groff', see the files `COPYING' and `LICENSE' in the top
-directory of the `groff' source package.  If not, see
-<http://www.gnu.org/licenses/>.
+Permission is granted to copy and distribute translations of this
+manual into another language, under the above conditions for modified
+versions, except that this permission notice may be included in
+translations approved by the Free Software Foundation instead of in
+the original English.
 ..
 .
 .
@@ -135,7 +131,7 @@ consistent indentation.
 Set line length.
 .
 If this option is not given,
-the line length is set to respect any value set by a prior `.ll' request,
+the line length is set to respect any value set by a prior `.ll' request
 (which
 .I must
 be in effect when the `.TH' macro is invoked),
@@ -184,6 +180,7 @@ Enumeration of pages start with
 .I nnn
 rather than with\~1.
 .
+.
 .TP
 .BI \-rS xx
 Base document font size is
@@ -221,7 +218,7 @@ This section describes the available macros for manual pages.
 .
 For further customization, put additional macros and requests into the
 file
-.B man.local
+.BR man.local ,
 which is loaded immediately after the
 .B man
 package.
@@ -234,7 +231,7 @@ package.
 Example/End Example.
 .
 After
-.BR EX ,
+.BR .EX ,
 filling is disabled and the font is set to constant-width.
 .
 This is useful for formatting code, command, and
@@ -244,6 +241,7 @@ The
 .B EE
 macro restores filling and restores the previous font.
 .
+.
 .IP
 These macros are defined on many (but not all) legacy Unix systems
 running classic troff.
@@ -264,10 +262,10 @@ The indentation is set to
 .I nnn
 if that argument is supplied (the default unit is `n' if omitted),
 otherwise it is set to the previous indentation value specified with
-.BR TP ,
-.BR IP ,
+.BR .TP ,
+.BR .IP ,
 or
-.B HP
+.B .HP
 (or to the default value if none of them have been used yet).
 .
 Font size and face are reset to its default values.
@@ -279,6 +277,7 @@ and
 .B .RE
 to set the left margin temporarily to the current indentation):
 .
+.
 .RS
 .HP 4
 This is a paragraph following an invocation of the
@@ -289,6 +288,7 @@ As you can see, it produces a paragraph where all lines but the first
 are indented.
 .RE
 .
+.
 .IP
 Use of this presentation-level macro is deprecated.
 .
@@ -311,26 +311,32 @@ The indentation is set to
 .I nnn
 if that argument is supplied (the default unit is `n' if omitted),
 otherwise it is set to the previous indentation value specified with
-.BR TP ,
-.BR IP ,
+.BR .TP ,
+.BR .IP ,
 or
-.B HP
+.B .HP
 (or to the default value if none of them have been used yet).
 .
 Font size and face of the paragraph (but not the designator) are reset
 to its default values.
 .
+.
 .IP
 To start an indented paragraph with a particular indentation but
 without a designator, use `""' (two doublequotes) as the second
 argument.
 .
+.
 .IP
 For example, the following paragraphs were all set up with bullets as
 the designator, using `.IP\ \\(bu\ 4'.
 .
-The whole block has been enclosed with `.RS' and `.RE' to set the left
-margin temporarily to the current indentation value.
+The whole block has been enclosed with
+.B .RS
+and
+.B .RE
+to set the left margin temporarily to the current indentation value.
+.
 .
 .RS
 .IP \(bu 4
@@ -339,12 +345,14 @@ is one of the three macros used in the
 .B man
 package to format lists.
 .
+.
 .IP \(bu 4
 .B HP
 is another.
 .
 This macro produces a paragraph with a left hanging indentation.
 .
+.
 .IP \(bu 4
 .B TP
 is another.
@@ -383,9 +391,9 @@ restoring the previous left margin.
 If no argument is given, it moves one level back.
 .
 The first level (i.e., no call to
-.B RS
+.B .RS
 yet) has number\~1, and each call to
-.B RS
+.B .RS
 increases the level by\~1.
 .
 .
@@ -395,10 +403,10 @@ This macro moves the left margin to the right by the value
 .I nnn
 if specified (default unit is `n'); otherwise it is set to the
 previous indentation value specified with
-.BR TP ,
-.BR IP ,
+.BR .TP ,
+.BR .IP ,
 or
-.B HP
+.B .HP
 (or to the default value if none of them have been used yet).
 .
 The indentation value is then set to the default.
@@ -415,10 +423,10 @@ macro can be nested.
 Set up an unnumbered section heading sticking out to the left.
 .
 Prints out all the text following
-.B SH
+.B .SH
 up to the end of the line (or the text in the next input line if there
 is no argument to
-.BR SH )
+.BR .SH )
 in bold face
 (or the font specified by the string
 .BR HF ),
@@ -433,10 +441,10 @@ text is reset to the default values.
 Set up a secondary, unnumbered section heading.
 .
 Prints out all the text following
-.B SS
+.B .SS
 up to the end of the line (or the text in the next input line if there
 is no argument to
-.BR SS )
+.BR .SS )
 in bold face
 (or the font specified by the string
 .BR HF ),
@@ -478,9 +486,11 @@ active).
 .I extra3
 is centered in the header line.
 .
+.
 .IP
 For HTML output, headers and footers are completely suppressed.
 .
+.
 .IP
 Additionally, this macro starts a new page; the new line number is\~1
 again (except if the `-rC1' option is given on the command line) --
@@ -501,12 +511,13 @@ The indentation is set to
 .I nnn
 if that argument is supplied (the default unit is `n' if omitted),
 otherwise it is set to the previous indentation value specified with
-.BR TP ,
-.BR IP ,
+.BR .TP ,
+.BR .IP ,
 or
-.B HP
+.B .HP
 (or to the default value if none of them have been used yet).
 .
+.
 .IP
 The first input line of text following this macro is interpreted as a
 string to be printed flush-left, as it is appropriate for a label.
@@ -525,6 +536,7 @@ Note that neither font shape nor font size of the label is set to a
 default value; on the other hand, the rest of the text has default
 font settings.
 .
+.
 .IP
 The
 .B TP
@@ -535,13 +547,21 @@ macro is the macro used for the explanations you are just reading.
 .B .TQ
 The
 .B TQ
-macro sets up header continuation for a .TP macro.
+macro sets up header continuation for a
+.B TP
+macro.
 .
 With it, you can stack up any number of labels (such as in a
 glossary, or list of commands) before beginning the indented
 paragraph.
 .
-For an example, look just past the next paragraph.
+For an example, look up the documentation of the
+.BR LP ,
+.BR PP ,
+and
+.BR P
+macros.
+.
 .
 .IP
 This macro is not defined on legacy Unix systems running classic
@@ -604,10 +624,12 @@ The text must be on the same line as the macro call.
 .
 Thus
 .
+.
 .RS
 .IP
 \&.BI this "word and" that
 .
+.
 .PP
 would cause `this' and `that' to appear in bold face, while `word and'
 appears in italics.
@@ -623,19 +645,6 @@ The text must be on the same line as the macro call.
 .
 .
 .TP
-.FONT B .FONT I " <font name> <text> " R [ I "<font name> <text> ..." R ]
-Use different font names on a single line.
-.
-Useful font names include
-.BR R ,
-.BR I ,
-.BR B ,
-.BR CR ,
-.BR CI ,
-.BR CB .
-.
-.
-.TP
 .BI .I " \fR[\fPtext\fR]\fP"
 Causes
 .I text
@@ -701,6 +710,7 @@ file of a
 .BR groff
 installation.
 .
+.
 .PP
 Using these macros helps ensure that you get hyperlinks when your
 manual page is rendered in a browser or other program that is
@@ -714,9 +724,9 @@ Web-enabled.
 Wrap an email address.
 .
 The argument of
-.B MT
+.B .MT
 is the address; text following, until
-.BR ME ,
+.BR .ME ,
 is a name to be associated with the address.
 .
 Any argument to the
@@ -725,21 +735,24 @@ macro is pasted to the end of the link text.
 .
 On a device that is not a browser,
 .
+.
 .RS
 .IP
 .EX
 contact
-\&.UR fred.foonly@\e:fubar.net
+\&.MT fred.foonly@\e:fubar.net
 Fred Foonly
-\&.UE
+\&.ME
 for more information
 .EE
 .RE
 .
+.
 .IP
 usually displays like this: \[lq]contact Fred Foonly
 <fred.foonly@\:fubar.net> for more information\[rq].
 .
+.
 .IP
 The use of
 .B \e:
@@ -754,9 +767,9 @@ be omitted.
 Wrap a World Wide Web hyperlink.
 .
 The argument to
-.B UR
+.B .UR
 is the URL; thereafter, lines until
-.B UE
+.B .UE
 are collected and used as the link text.
 .
 Any argument to the
@@ -765,6 +778,7 @@ macro is pasted to the end of the text.
 .
 On a device that is not a browser,
 .
+.
 .RS
 .IP
 .EX
@@ -776,10 +790,12 @@ given as an example
 .EE
 .RE
 .
+.
 .IP
 usually displays like this: \[lq]this is a link to some random
 site <http://\:randomsite.org/\:fubar>, given as an example\[rq].
 .
+.
 .IP
 The use of
 .B \e:
@@ -800,6 +816,7 @@ file of a
 .BR groff
 installation.
 .
+.
 .PP
 These macros are a convenience for authors.
 They also assist automated translation tools and help browsers in
@@ -823,7 +840,7 @@ Begin synopsis.
 Takes a single argument, the name of a command.
 .
 Text following, until closed by
-.BR YS ,
+.BR .YS ,
 is set with a hanging indentation with the width of
 .I command
 plus a space.
@@ -836,9 +853,11 @@ This produces the traditional look of a Unix command synopsis.
 This macro restores normal indentation at the end of a command
 synopsis.
 .
+.
 .PP
 Here is a real example:
 .
+.
 .IP
 .EX
 \&.SY groff
@@ -863,9 +882,11 @@ Here is a real example:
 \&.YS
 .EE
 .
+.
 .PP
 produces the following output:
 .
+.
 .RS
 .PP
 .SY groff
@@ -890,6 +911,7 @@ produces the following output:
 .YS
 .RE
 .
+.
 .PP
 If necessary, you might use
 .B br
@@ -904,7 +926,7 @@ You can insert plain text as well; this looks like the traditional
 .
 The default indentation is 7.2n in troff mode and 7n in nroff mode
 except for
-.B grohtml
+.BR grohtml ,
 which ignores indentation.
 .
 .
@@ -932,9 +954,10 @@ Set tabs every 0.5\~inches.
 .
 Since this macro is always called during a
 .B TH
-request, it makes sense to call it only if the tab positions have been
+macro, it makes sense to call it only if the tab positions have been
 changed.
 .
+.
 .IP
 Use of this presentation-level macro is deprecated.
 .
@@ -942,7 +965,7 @@ It translates poorly to HTML, under which exact whitespace control
 and tabbing are not readily available.
 .
 Thus, information or distinctions that you use
-.B DT
+.B .DT
 to express are likely to be lost.
 .
 If you feel tempted to use it, you should probably be composing a
@@ -950,6 +973,7 @@ table using
 .BR @g@tbl (@MAN1EXT@)
 markup instead.
 .
+.
 .TP
 .BI .PD " \fR[\fPnnn\fR]\fP"
 Adjust the empty space before a new paragraph or section.
@@ -971,6 +995,7 @@ and
 and
 .BR HP .
 .
+.
 .IP
 Use of this presentation-level macro is deprecated.
 .
@@ -978,7 +1003,7 @@ It translates poorly to HTML, under which exact control of
 inter-paragraph spacing is not readily available.
 .
 Thus, information or distinctions that you use
-.B PD
+.B .PD
 to express are likely to be lost.
 .
 .
@@ -1092,7 +1117,7 @@ render it to HTML.
 Troff requests make implicit assumptions about things like character
 and page sizes that may break in an HTML environment; also, many of
 these viewers don't interpret the full troff vocabulary, a problem
-which can lead to portions of your text being silently dropped.
+that can lead to portions of your text being silently dropped.
 .
 .
 .PP
@@ -1101,10 +1126,10 @@ entirely in the requests described on this page.
 .
 Further, it is best to completely avoid those we have described as
 `presentation-level'
-.RB ( HP ,
-.BR PD ,
+.RB ( .HP ,
+.BR .PD ,
 and
-.BR DT ).
+.BR .DT ).
 .
 .
 .PP
@@ -1168,6 +1193,7 @@ portability to legacy Unix systems are encouraged to copy these
 definitions into their pages, and maintainers of troff
 or its workalikes are encouraged to re-use them.
 .
+.
 .IP
 Note that the definitions for these macros are read after the call of
 .BR TH ,
@@ -1222,13 +1248,6 @@ Eric S. Raymond
 he also wrote the portability advice.
 .
 .
-.PP
-It was put under GPL2 and ordered and extended by
-.MT groff-bernd.warken-72@web.de
-Bernd Warken
-.ME .
-.
-.
 .\" ----------------------------------------------------------------------
 .\" ### Emacs settings:
 .\" Local Variables:


hooks/post-receive
-- 
GNU troff


From MAILER-DAEMON Mon Jan 06 07:56:11 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1W09j1-0006ae-Ns
	for mharc-groff-commit@gnu.org; Mon, 06 Jan 2014 07:56:11 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:60334)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bernd.warken@web.de>) id 1W09iy-0006V8-4Q
	for groff-commit@gnu.org; Mon, 06 Jan 2014 07:56:10 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bernd.warken@web.de>) id 1W09iw-0003CN-Es
	for groff-commit@gnu.org; Mon, 06 Jan 2014 07:56:08 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:48809)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bernd.warken@web.de>) id 1W09iw-0003CJ-AL
	for groff-commit@gnu.org; Mon, 06 Jan 2014 07:56:06 -0500
Received: from bwarken by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <bernd.warken@web.de>) id 1W09ip-00024f-As
	for groff-commit@gnu.org; Mon, 06 Jan 2014 12:56:02 +0000
Date: Mon, 06 Jan 2014 12:56:01 +0000
Message-Id: <E1W09ip-00024f-As@vcs.savannah.gnu.org>
From: "Bernd Warken" <groff-bernd.warken-72@web.de>
To: groff-commit@gnu.org
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: f64b964b306322b7f02e07d4be58a6adbb0a0ecd
X-Git-Newrev: f30e92a0bb111ade9e690ddc4671f41a82da4342
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
Subject: [Groff-commit] GNU troff branch, master,
	updated. f30e92a0bb111ade9e690ddc4671f41a82da4342
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 06 Jan 2014 12:56:10 -0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU troff".

http://git.sv.gnu.org/gitweb/?p=groff.git;a=commitdiff;h=f30e92a0bb111ade9e690ddc4671f41a82da4342

The branch, master has been updated
       via  f30e92a0bb111ade9e690ddc4671f41a82da4342 (commit)
      from  f64b964b306322b7f02e07d4be58a6adbb0a0ecd (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit f30e92a0bb111ade9e690ddc4671f41a82da4342
Author: Bernd Warken <groff-bernd.warken-72@web.de>
Date:   Mon Jan 6 13:55:41 2014 +0100

    Fix some reasonable stuff

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog                                   |    8 ++++
 Makefile.in                                 |    2 +-
 contrib/glilypond/ChangeLog                 |    8 +++-
 contrib/groff_filenames/ChangeLog           |    4 ++
 contrib/groff_filenames/Makefile.sub        |   10 ++--
 contrib/groff_filenames/groff_filenames.man |    4 +-
 man/roff.man                                |   54 +++++++++++++++++++++++----
 7 files changed, 72 insertions(+), 18 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index af6efd8..0d0d16a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2014-01-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/roff.man: Add information of new archives for RUNOFF and
+	roff_classical.
+
+	* Makefile.in: Replace `contrib/RUNOFF' by
+	`contrib/groff_filenames'.
+
 2014-01-05  Bernd Warken  <groff-bernd.warken-72@web.de>
 	    Werner LEMBERG  <wl@gnu.org>
 
diff --git a/Makefile.in b/Makefile.in
index 1fa225a..a7f1b64 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -630,7 +630,7 @@ OTHERDIRS=\
   src/roff/grog \
   src/roff/nroff \
   doc \
-  contrib/RUNOFF \
+  contrib/groff_filenames \
   contrib/mm \
   contrib/chem \
   contrib/pic2graph \
diff --git a/contrib/glilypond/ChangeLog b/contrib/glilypond/ChangeLog
index 3017ad8..e7495fa 100644
--- a/contrib/glilypond/ChangeLog
+++ b/contrib/glilypond/ChangeLog
@@ -1,3 +1,7 @@
+2014-01-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	Remove archive git@github.com:RUNOFF/groff_lilypond.git
+
 2013-10-30  Bernd Warken  <groff-bernd.warken-72@web.de>
 
 	* glilypond.man: Correct writing.
@@ -132,8 +136,8 @@
 
 ########################################################################
 
-Copyright 2013
-  Free Software Foundation, Inc.
+Copyright 2013-2014
+	Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
diff --git a/contrib/groff_filenames/ChangeLog b/contrib/groff_filenames/ChangeLog
index 50b0514..226792d 100644
--- a/contrib/groff_filenames/ChangeLog
+++ b/contrib/groff_filenames/ChangeLog
@@ -1,3 +1,7 @@
+2014-01-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Makefile.sub: fix this file
+
 2014-01-05  Bernd Warken  <groff-bernd.warken-72@web.de>
 
 	* runoff.man: remove this file
diff --git a/contrib/groff_filenames/Makefile.sub b/contrib/groff_filenames/Makefile.sub
index 5f2a3c1..af8d400 100644
--- a/contrib/groff_filenames/Makefile.sub
+++ b/contrib/groff_filenames/Makefile.sub
@@ -1,15 +1,15 @@
-# Makefile.sub for `RUNOFF' (integration into the `groff' source tree)
+# Makefile.sub for `groiff_filenames' (integration into the `groff' source tree)
 
-# File position: <groff-source>/contrib/RUNOFF/Makefile.sub
+# File position: <groff-source>/contrib/groff_filenames/Makefile.sub
 
-# Copyright (C) 2013, 2014
+# Copyright (C) 2013-2014
 #   Free Software Foundation, Inc.
 #
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
-# Last update: 5 Jan 2014
+# Last update: 6 Jan 2014
 
-# This file is part of `RUNOFF' which is part of `groff'.
+# This file is part of `groff'.
 
 # `groff' is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License as published by
diff --git a/contrib/groff_filenames/groff_filenames.man b/contrib/groff_filenames/groff_filenames.man
index 940acd2..1523eac 100644
--- a/contrib/groff_filenames/groff_filenames.man
+++ b/contrib/groff_filenames/groff_filenames.man
@@ -1,6 +1,6 @@
 .TH GROFF_FILENAMES @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
 .SH NAME
-groff_filenames \- filename extensions for RUNOFF, roff and groff
+groff_filenames \- filename extensions for roff and groff
 .
 .\" The .SH was moved to this place in order to appease `apropos'.
 .
@@ -25,7 +25,7 @@ Free Software Foundation, Inc.
 .
 .
 .P
-Last update: 5 Jan 2014
+Last update: 6 Jan 2014
 .
 .
 .P
diff --git a/man/roff.man b/man/roff.man
index 32e320c..faf4903 100644
--- a/man/roff.man
+++ b/man/roff.man
@@ -185,23 +185,38 @@ had additional features added, such as the ability to do two-pass
 formatting; it became the main format for Multics documentation and text
 processing.
 .
+.
 .P
 BCPL and
 .B runoff
 were ported to the GCOS system at Bell Labs when BTL left the development of
 Multics.
 .
+.
 .P
-There is a free
-.I git
-package at
-.I github
-consisting of the available RUNOFF documentation and RUNOFF files.
+There is a free archive about
+.I historical RUNOFF
+documents.
 .
-You can call it anonymously by the shell command
+You can get it anonymously by the shell command
+.RS
 .EX
-$ git clone git@github.com:RUNOFF/RUNOFF.git
+$git clone https://github.com/bwarken/RUNOFF_historical.git
 .EE
+.RE
+.
+.
+.P
+As well, there is a new project for writing a program that can read
+.I "RUNOFF files" ,
+but it does not yet work so far.
+.
+You can get an early version anonymously by the shell command
+.RS
+.EX
+$git clone https://github.com/bwarken/runoff.git
+.EE
+.RE
 .
 .
 .\" --------------------------------------------------------------------
@@ -909,6 +924,13 @@ where
 is either a system supplied command or a shell script of your own.
 .
 .
+.P
+More details for
+.I file name extensions
+can be found at
+.BR groff_filenames (7).
+.
+.
 .\" --------------------------------------------------------------------
 .SH "EDITING ROFF"
 .\" --------------------------------------------------------------------
@@ -1219,6 +1241,22 @@ J. L. Bentley, L. W. Jelinski, and B. W. Kernighan,
 Bell Labs, April 1986.
 .
 .
+.P
+You can get an archive with most
+.I classical roff documentation
+as reasonable
+.I PDF files
+at
+.I github
+using the
+.I shell command
+.RS
+.EX
+$ git clone https://github.com/bwarken/roff_classical.git
+.EE
+.RE
+.
+.
 .\" --------------------------------------------------------------------
 .SS "Manual Pages"
 .\" --------------------------------------------------------------------
@@ -1251,7 +1289,7 @@ might be a good starting point.
 .SH AUTHORS
 .\" --------------------------------------------------------------------
 .
-Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006, 2007, 2008, 2009
+Copyright (C) 2000-2004, 2006-2009, 2014
 Free Software Foundation, Inc.
 .
 .P


hooks/post-receive
-- 
GNU troff


From MAILER-DAEMON Tue Jan 28 17:02:29 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1W8Gjk-0006Gw-Vy
	for mharc-groff-commit@gnu.org; Tue, 28 Jan 2014 17:02:28 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:50248)
	by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1W8Gji-0006GQ-Be
	for groff-commit@gnu.org; Tue, 28 Jan 2014 17:02:27 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <wl@gnu.org>) id 1W8Gjb-0006gX-Ai
	for groff-commit@gnu.org; Tue, 28 Jan 2014 17:02:26 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:47715)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1W8Gjb-0006gR-7U
	for groff-commit@gnu.org; Tue, 28 Jan 2014 17:02:19 -0500
Received: from wl by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <wl@gnu.org>) id 1W8Gja-0007ai-LD
	for groff-commit@gnu.org; Tue, 28 Jan 2014 22:02:18 +0000
Date: Tue, 28 Jan 2014 22:02:18 +0000
Message-Id: <E1W8Gja-0007ai-LD@vcs.savannah.gnu.org>
From: "Werner Lemberg" <wl@gnu.org>
To: groff-commit@gnu.org
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: f30e92a0bb111ade9e690ddc4671f41a82da4342
X-Git-Newrev: 983a5de8003d7b08964c7e2a5db26a579dc18748
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
Subject: [Groff-commit] GNU troff branch, master,
	updated. 983a5de8003d7b08964c7e2a5db26a579dc18748
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 28 Jan 2014 22:02:27 -0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU troff".

http://git.sv.gnu.org/gitweb/?p=groff.git;a=commitdiff;h=983a5de8003d7b08964c7e2a5db26a579dc18748

The branch, master has been updated
       via  983a5de8003d7b08964c7e2a5db26a579dc18748 (commit)
      from  f30e92a0bb111ade9e690ddc4671f41a82da4342 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 983a5de8003d7b08964c7e2a5db26a579dc18748
Author: Ulrich Spörlein <uqs@FreeBSD.org>
Date:   Tue Jan 28 23:01:33 2014 +0100

    * tmac/doc-common: Add some new *BSD version strings.

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog       |    4 ++++
 tmac/doc-common |   18 ++++++++++++++++++
 2 files changed, 22 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0d0d16a..609f79a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2014-01-28  Ulrich Spörlein  <uqs@FreeBSD.org>
+
+	* tmac/doc-common: Add some new *BSD version strings.
+
 2014-01-06  Bernd Warken  <groff-bernd.warken-72@web.de>
 
 	* man/roff.man: Add information of new archives for RUNOFF and
diff --git a/tmac/doc-common b/tmac/doc-common
index a82502c..de15576 100644
--- a/tmac/doc-common
+++ b/tmac/doc-common
@@ -485,7 +485,15 @@
 .ds doc-operating-system-NetBSD-5.0.1 5.0.1
 .ds doc-operating-system-NetBSD-5.0.2 5.0.2
 .ds doc-operating-system-NetBSD-5.1   5.1
+.ds doc-operating-system-NetBSD-5.1.2 5.1.2
+.ds doc-operating-system-NetBSD-5.1.3 5.1.3
+.ds doc-operating-system-NetBSD-5.2   5.2
+.ds doc-operating-system-NetBSD-5.2.1 5.2.1
 .ds doc-operating-system-NetBSD-6.0   6.0
+.ds doc-operating-system-NetBSD-6.0.1 6.0.1
+.ds doc-operating-system-NetBSD-6.0.2 6.0.2
+.ds doc-operating-system-NetBSD-6.0.3 6.0.3
+.ds doc-operating-system-NetBSD-6.1   6.1
 .
 .ds doc-operating-system-OpenBSD-2.0  2.0
 .ds doc-operating-system-OpenBSD-2.1  2.1
@@ -518,6 +526,10 @@
 .ds doc-operating-system-OpenBSD-4.8  4.8
 .ds doc-operating-system-OpenBSD-4.9  4.9
 .ds doc-operating-system-OpenBSD-5.0  5.0
+.ds doc-operating-system-OpenBSD-5.1  5.1
+.ds doc-operating-system-OpenBSD-5.2  5.2
+.ds doc-operating-system-OpenBSD-5.3  5.3
+.ds doc-operating-system-OpenBSD-5.4  5.4
 .
 .ds doc-operating-system-FreeBSD-1.0     1.0
 .ds doc-operating-system-FreeBSD-1.1     1.1
@@ -536,6 +548,7 @@
 .ds doc-operating-system-FreeBSD-2.2.6   2.2.6
 .ds doc-operating-system-FreeBSD-2.2.7   2.2.7
 .ds doc-operating-system-FreeBSD-2.2.8   2.2.8
+.ds doc-operating-system-FreeBSD-2.2.9   2.2.9
 .ds doc-operating-system-FreeBSD-3.0     3.0
 .ds doc-operating-system-FreeBSD-3.1     3.1
 .ds doc-operating-system-FreeBSD-3.2     3.2
@@ -576,6 +589,7 @@
 .ds doc-operating-system-FreeBSD-8.1     8.1
 .ds doc-operating-system-FreeBSD-8.2     8.2
 .ds doc-operating-system-FreeBSD-9.0     9.0
+.ds doc-operating-system-FreeBSD-10.0    10.0
 .
 .ds doc-operating-system-Darwin-8.0.0  8.0.0
 .ds doc-operating-system-Darwin-8.1.0  8.1.0
@@ -629,6 +643,10 @@
 .ds doc-operating-system-DragonFly-2.10   2.10
 .ds doc-operating-system-DragonFly-2.10.1 2.10.1
 .ds doc-operating-system-DragonFly-2.11   2.11
+.ds doc-operating-system-DragonFly-3.0    3.0
+.ds doc-operating-system-DragonFly-3.2    3.2
+.ds doc-operating-system-DragonFly-3.4    3.4
+.ds doc-operating-system-DragonFly-3.6    3.6
 .
 .de Os
 .  ds doc-command-name


hooks/post-receive
-- 
GNU troff


From MAILER-DAEMON Wed Jan 29 10:11:42 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1W8Wnm-0004Gd-CH
	for mharc-groff-commit@gnu.org; Wed, 29 Jan 2014 10:11:42 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:48799)
	by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1W8Wnk-0004Ez-45
	for groff-commit@gnu.org; Wed, 29 Jan 2014 10:11:41 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <wl@gnu.org>) id 1W8Wni-0000Mw-WC
	for groff-commit@gnu.org; Wed, 29 Jan 2014 10:11:40 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:57570)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1W8Wni-0000Ms-Sg
	for groff-commit@gnu.org; Wed, 29 Jan 2014 10:11:38 -0500
Received: from wl by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <wl@gnu.org>) id 1W8Wni-0004fX-4q
	for groff-commit@gnu.org; Wed, 29 Jan 2014 15:11:38 +0000
Date: Wed, 29 Jan 2014 15:11:38 +0000
To: groff-commit@gnu.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Message-ID: <20140129151138.17919.8653@vcs.savannah.gnu.org>
Mail-Followup-To: groff@gnu.org
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Oldrev: 983a5de8003d7b08964c7e2a5db26a579dc18748
X-Git-Newrev: 819839b66c80e8dabe6cb24ea6319c26c9a2be14
Auto-Submitted: auto-generated
From: Werner LEMBERG <wl@gnu.org>
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
Subject: [Groff-commit] [groff] branch master updated (983a5de -> 819839b)
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 29 Jan 2014 15:11:41 -0000

wl pushed a change to branch master
in repository groff.

      from  983a5de   * tmac/doc-common: Add some new *BSD version strings.
       new  819839b   * tmac/doc-common: Add even more DragonFlyBSD releases.

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "adds" were already present in the repository and have only
been added to this reference.


Summary of changes:
 ChangeLog       |    4 ++++
 tmac/doc-common |   12 ++++++++++++
 2 files changed, 16 insertions(+), 0 deletions(-)


From MAILER-DAEMON Wed Jan 29 10:11:47 2014
Received: from list by lists.gnu.org with archive (Exim 4.71)
	id 1W8Wnr-0004HE-HQ
	for mharc-groff-commit@gnu.org; Wed, 29 Jan 2014 10:11:47 -0500
Received: from eggs.gnu.org ([2001:4830:134:3::10]:48808)
	by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1W8Wnk-0004F0-JK
	for groff-commit@gnu.org; Wed, 29 Jan 2014 10:11:45 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <wl@gnu.org>) id 1W8Wnj-0000N4-8C
	for groff-commit@gnu.org; Wed, 29 Jan 2014 10:11:40 -0500
Received: from vcs.savannah.gnu.org ([140.186.70.72]:57573)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <wl@gnu.org>)
	id 1W8Wnj-0000N0-4w
	for groff-commit@gnu.org; Wed, 29 Jan 2014 10:11:39 -0500
Received: from wl by vcs.savannah.gnu.org with local (Exim 4.72)
	(envelope-from <wl@gnu.org>) id 1W8Wni-0004g1-Qj
	for groff-commit@gnu.org; Wed, 29 Jan 2014 15:11:38 +0000
Date: Wed, 29 Jan 2014 15:11:38 +0000
Message-Id: <E1W8Wni-0004g1-Qj@vcs.savannah.gnu.org>
To: groff-commit@gnu.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
In-Reply-To: groff@gnu.org
References: <20140129151138.17919.8653@vcs.savannah.gnu.org>
X-Git-Repo: groff
X-Git-Refname: refs/heads/master
X-Git-Reftype: branch
X-Git-Rev: 819839b66c80e8dabe6cb24ea6319c26c9a2be14
Auto-Submitted: auto-generated
From: Werner LEMBERG <wl@gnu.org>
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 140.186.70.72
Subject: [Groff-commit] [groff] 01/01: * tmac/doc-common: Add even more
 DragonFlyBSD releases.
X-BeenThere: groff-commit@gnu.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: =?utf-8?q?Ulrich_Sp=C3=B6rlein?= <uqs@FreeBSD.org>
List-Id: <groff-commit.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/groff-commit>
List-Post: <mailto:groff-commit@gnu.org>
List-Help: <mailto:groff-commit-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/groff-commit>,
	<mailto:groff-commit-request@gnu.org?subject=subscribe>
X-List-Received-Date: Wed, 29 Jan 2014 15:11:45 -0000

wl pushed a commit to branch master
in repository groff.

commit 819839b66c80e8dabe6cb24ea6319c26c9a2be14
Author: Ulrich Spörlein <uqs@FreeBSD.org>
Date:   Wed Jan 29 16:10:52 2014 +0100

    * tmac/doc-common: Add even more DragonFlyBSD releases.
---
 ChangeLog       |    4 ++++
 tmac/doc-common |   12 ++++++++++++
 2 files changed, 16 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 609f79a..5a9ba7f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2014-01-29  Ulrich Spörlein  <uqs@FreeBSD.org>
+
+	* tmac/doc-common: Add even more DragonFlyBSD releases.
+
 2014-01-28  Ulrich Spörlein  <uqs@FreeBSD.org>
 
 	* tmac/doc-common: Add some new *BSD version strings.
diff --git a/tmac/doc-common b/tmac/doc-common
index de15576..2d91c7c 100644
--- a/tmac/doc-common
+++ b/tmac/doc-common
@@ -628,15 +628,23 @@
 .ds doc-operating-system-DragonFly-1.4    1.4
 .ds doc-operating-system-DragonFly-1.5    1.5
 .ds doc-operating-system-DragonFly-1.6    1.6
+.ds doc-operating-system-DragonFly-1.7    1.7
 .ds doc-operating-system-DragonFly-1.8    1.8
 .ds doc-operating-system-DragonFly-1.8.1  1.8.1
+.ds doc-operating-system-DragonFly-1.9    1.9
 .ds doc-operating-system-DragonFly-1.10   1.10
+.ds doc-operating-system-DragonFly-1.11   1.11
 .ds doc-operating-system-DragonFly-1.12   1.12
 .ds doc-operating-system-DragonFly-1.12.2 1.12.2
+.ds doc-operating-system-DragonFly-1.13   1.13
 .ds doc-operating-system-DragonFly-2.0    2.0
+.ds doc-operating-system-DragonFly-2.1    2.1
 .ds doc-operating-system-DragonFly-2.2    2.2
+.ds doc-operating-system-DragonFly-2.3    2.3
 .ds doc-operating-system-DragonFly-2.4    2.4
+.ds doc-operating-system-DragonFly-2.5    2.5
 .ds doc-operating-system-DragonFly-2.6    2.6
+.ds doc-operating-system-DragonFly-2.7    2.7
 .ds doc-operating-system-DragonFly-2.8    2.8
 .ds doc-operating-system-DragonFly-2.9    2.9
 .ds doc-operating-system-DragonFly-2.9.1  2.9.1
@@ -644,9 +652,13 @@
 .ds doc-operating-system-DragonFly-2.10.1 2.10.1
 .ds doc-operating-system-DragonFly-2.11   2.11
 .ds doc-operating-system-DragonFly-3.0    3.0
+.ds doc-operating-system-DragonFly-3.1    3.1
 .ds doc-operating-system-DragonFly-3.2    3.2
+.ds doc-operating-system-DragonFly-3.3    3.3
 .ds doc-operating-system-DragonFly-3.4    3.4
+.ds doc-operating-system-DragonFly-3.5    3.5
 .ds doc-operating-system-DragonFly-3.6    3.6
+.ds doc-operating-system-DragonFly-3.7    3.7
 .
 .de Os
 .  ds doc-command-name


